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

Related MCP server: TalkToAnki

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

Configuration

All configuration is via environment variables with sensible defaults:

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