anki-mcp

MCP server for Anki via AnkiConnect — create, search, and manage flashcards directly from Claude Code or any MCP client.

Features

• Card CRUD — create (bulk with duplicate detection), search, update, delete
• Deck management — list, create (supports :: hierarchy)
• Archive & sync — export/import .apkg files, trigger AnkiWeb sync
• Progress analytics — deck maturity, Interest Heat Score (which topics you retain best), study streak
• Conversation extraction — /anki extract scans a conversation for learnable moments and proposes cards
• Daily progress script — cron-friendly report generator that reads Anki's SQLite directly
• Claude Code skill — interactive card creation via /anki slash command

Requirements

• Python 3.13+
• uv
• Anki desktop running
• AnkiConnect addon installed (addon code 2055492159)
• Claude Code or any MCP client

Installation

git clone https://github.com/chaosisnotrandomitisrhythmic/anki-mcp.git
cd anki-mcp
uv sync

Usage

Add to your MCP config (~/.claude/settings.json, project .mcp.json, or Claude Desktop config):

{
  "mcpServers": {
    "anki": {
      "command": "uv",
      "args": ["--directory", "/path/to/anki-mcp", "run", "anki-mcp"]
    }
  }
}

Tools

Tool	Description
add_notes	Create flashcards (bulk, with duplicate detection)
search_notes	Find cards using Anki query syntax
update_note	Edit a card's fields or tags
delete_notes	Remove cards by ID
list_decks	All decks with card counts (new/learn/review)
create_deck	Create a deck (supports :: hierarchy)
export_deck	Export deck to .apkg (optionally archive + delete)
import_deck	Restore .apkg from archive
sync	Trigger AnkiWeb sync
progress	Learning report with Interest Heat Score
health	Check AnkiConnect connectivity

Configuration

All configuration is via environment variables with sensible defaults:

Variable	Description	Default
ANKI_MCP_ARCHIVE_DIR	Directory for .apkg exports/imports	~/.local/share/anki-mcp/archive
ANKI_DB_PATH	Path to Anki's collection.anki2	Platform-aware (macOS: ~/Library/Application Support/Anki2/User 1/collection.anki2, Linux: ~/.local/share/Anki2/User 1/collection.anki2)
ANKI_MCP_OUTPUT_DIR	Directory for daily progress reports	~/Anki Progress

Daily Progress Script

A standalone script that reads Anki's SQLite database and generates a Markdown progress report. Works even when Anki is running (read-only via WAL mode).

# Run manually
cd /path/to/anki-mcp && uv run python scripts/daily_progress.py

# Cron example (daily at 7:03 AM)
3 7 * * * cd /path/to/anki-mcp && uv run python scripts/daily_progress.py

The report includes deck overview, Interest Heat Score, and study streak.

Claude Code Skill

The skills/SKILL.md file provides a Claude Code skill for interactive card creation. It supports:

• /anki — manual card creation
• /anki extract — scan conversation for extractable knowledge and create cards
• /anki progress — show learning progress

Uninstallation

1. Remove the anki entry from mcpServers in your MCP config
2. Optionally remove the skill: rm -rf ~/.claude/skills/anki/
3. Optionally delete the archive directory (~/.local/share/anki-mcp/ by default)
4. Remove the repo: rm -rf /path/to/anki-mcp

Your Anki cards are stored in Anki itself — nothing is lost by removing this server.

Contributing

See CONTRIBUTING.md.

Security

See SECURITY.md.

License

MIT