Anki MCP Server

What Anki MCP Server MCP server does

Anki MCP Server MCP server gives an AI assistant access to an Anki collection through AnkiConnect. It covers study workflows, collection maintenance, and content creation rather than only read-only lookup. Agents can synchronize with AnkiWeb, retrieve due or filtered cards, show a card front, record a review rating, and change suspension or scheduling state.

The server also supports deck and note operations. An agent can list or create decks, move cards, create notes individually or in batches, search notes with Anki query syntax, update fields, and delete notes with confirmation. Tag operations include adding, removing, replacing, and clearing unused tags.

Media tools list files in Anki's collection.media directory, retrieve files as base64, store files from base64, an absolute path, or a URL, and delete files. Model discovery is available through the modelNames tool, which helps an agent identify note types before creating notes.

How it works

Requests arrive through MCP and are translated into Anki operations through AnkiConnect. The sync operation pulls current data from AnkiWeb and pushes local changes. Review actions have different effects: rate_card records a performance rating and schedules the next review, while forgetCards resets a card to new without recording a review, and setDueDate changes its due timing without recording a review.

Card retrieval can be limited by deck and state, including due, new, learning, suspended, and buried. The get_due_cards and get_cards tools do not return answers unless include_answer is set to true. Note searches accept Anki query syntax such as deck:, tag:, and is:due.

Batch note creation supports up to 100 notes sharing a deck and model, with partial success possible. Deck creation supports a Parent::Child structure up to two levels. Destructive operations include deleting notes, removing media, and clearing unused tags.

Setup and configuration

The project documentation identifies AnkiConnect as the connection layer between the MCP server and Anki. The repository also publishes an npm package named @ankimcp/anki-mcp-server and identifies Claude Desktop in its documentation examples. The supplied material does not specify installation commands, required environment variables, transport settings, or AnkiConnect configuration steps.

Tools and capabilities

• Review due or filtered cards, present card fronts, rate performance, reset scheduling, set due dates, and manage suspension.
• Synchronize with AnkiWeb and inspect deck-level or collection-wide statistics.
• Create, search, update, batch-create, tag, and delete notes.
• List, retrieve, store, and delete collection media files.
• List available note types and use them when creating notes.

Limitations and notes

Anki MCP Server MCP server is marked beta, so its APIs and features may change. Operations that delete notes, media, or unused tags are destructive. Card answers are hidden by default in the two card retrieval tools. The supplied material does not document authentication, supported operating systems, or client compatibility beyond the Claude Desktop example.