Anki MCP Server

Anki MCP Server

Seamlessly integrate Anki with AI assistants through the Model Context Protocol

Beta - This project is in active development. APIs and features may change.

A Model Context Protocol (MCP) server that enables AI assistants to interact with Anki, the spaced repetition flashcard application.

Transform your Anki experience with natural language interaction - like having a private tutor. The AI assistant doesn't just present questions and answers; it can explain concepts, make the learning process more engaging and human-like, provide context, and adapt to your learning style. It can create and edit notes on the fly, turning your study sessions into dynamic conversations. More features coming soon!

Examples and Tutorials

For comprehensive guides, real-world examples, and step-by-step tutorials on using this MCP server with Claude Desktop, visit:

ankimcp.ai - Complete documentation with practical examples and use cases

See docs/ for supplementary documentation, including the reviewer setup guide and the sample Anki deck.

Example Use Cases

Three representative prompts showing the tool flows this server enables:

1. "Help me review my Spanish deck." — The assistant syncs with AnkiWeb (sync), fetches due cards (getduecards with deck filter), presents each card (presentcard), and records your rating (ratecard). Natural study conversation with explanations tailored to you.

1. "Create 10 Arabic vocab cards with RTL styling." — The assistant lists note types (modelNames), creates a custom RTL model if needed (createModel + updateModelStyling for right-to-left CSS), then batch-creates the cards (addNotes).

1. "Import this image from my Downloads folder into the front of the selected note." — The assistant uploads the local file (storeMediaFile with a file path), reads the currently-selected note from the browser (guiSelectedNotes + notesInfo), and updates the front field with an tag (updateNoteFields).

Available Tools

The server exposes 53 MCP tools — 42 essential tools for everyday Anki operations and 11 GUI tools that drive the Anki desktop interface for note editing/creation workflows.

Essential Tools

Review & Study

• sync - Sync with AnkiWeb to pull latest data and push changes
• getduecards - Get cards that are due for review, optionally filtered by deck (answers omitted unless include_answer: true, default false)
• getcards - Get cards with flexible filtering by state (due, new, learning, suspended, buried) and deck (answers omitted unless includeanswer: true, default false)
• present_card - Show a card for review with its question/front side
• rate_card - Rate card performance (Again, Hard, Good, Easy) and schedule the next review
• forgetCards - Reset cards to new, discarding their scheduling without recording a review
• setDueDate - Reschedule cards to become due in N days ("0", "3-7", "1!"), without recording a review
• areSuspended - Check suspension state for one or more cards without changing anything
• suspend - Suspend cards so they are skipped during review until unsuspended
• unsuspend - Unsuspend cards so they return to normal review

Shortened. The full README is on GitHub.