AnkiConnect MCP Server

Python MCP server for AnkiConnect. Deck review assistant: walk through a deck card by card, spot gaps (verb forms, declension), fix with approval.

Prerequisites

• Anki 2.1.x running in the background
• AnkiConnect add-on (install code: 2055492159)
• Python 3.11+

Verify AnkiConnect: open http://127.0.0.1:8765 — you should see AnkiConnect.

Installation

cd AnkiConnectMCP
python -m pip install -e .

Cursor MCP configuration

In .cursor/mcp.json (or Cursor Settings → MCP):

{
  "mcpServers": {
    "anki-connect": {
      "command": "python",
      "args": ["-m", "anki_connect_mcp.server"],
      "cwd": "C:/Users/Fabian/Desktop/Projekte/AnkiConnectMCP",
      "env": {
        "PYTHONPATH": "src",
        "ANKI_CONNECT_URL": "http://127.0.0.1:8765"
      }
    }
  }
}

Reload the MCP server after code changes.

How it works

Typical session — no JSON, just chat:

Du:  „Geh mein Italienisch-Deck durch — Verben sollen alle Formen auf einer Karte haben“

KI:  list_deck_cards(deck_name="Italienisch", offset=0)
     → #1–#15 mit Front/Back

     Chat-Analyse:
     #3  mangiare — Partizip fehlt
     #7  il libro — nicht dekliniert
     Soll ich #3 anpassen?

Du:  „ja, Partizip mangiato“

KI:  BEFORE/AFTER im Chat + edit_card(note_id=…, back="…")

Du:  „weiter“ / „nächster Block“ / „#7 auch“

New chat message while Run is pending = revision, not blind apply.

Tools

Tool	Description
list_decks	Deck names
list_deck_cards	Numbered page of cards for systematic review
get_card	One card in detail
search_cards	Targeted search (verbs, tags, text)
edit_card	Apply one approved edit
add_card	Add one new card

Security

• Read tools never modify Anki.
• Writes only after Cursor Run approval.
• No delete tools. Optional ALLOWED_DECKS allowlist.
• One tool at a time (server lock).

License

MIT