AnkiWeb addon 593632040
Runs a local MCP server inside Anki so Claude or other LLM clients can create, search, edit, move and study your cards conversationally, plus analyze retention.
Open on AnkiWeb GitHub Find alternatives
active
| Min Anki | Max Anki | Updated |
|---|---|---|
| 23.10 | + | 2026-10-17 |
Loadingβ¦
Runs a local MCP server inside Anki so AI assistants can create cards, quiz you, search and manage decks live, with an optional public tunnel for remote access.
Lets you answer flashcards by typing, speaking, or handwriting, then has a chosen LLM grade the answer as correct, partly, or totally wrong and explain mistakes.
Explains topics, chats about study material, and generates basic, cloze, image-occlusion, and audio cards from notes, documents, and images, with free local text-to-speech.
Generates AI study explanations, examples, hints, quizzes, and card-improvement suggestions from card content using Gemini, OpenAI, or Claude, then displays, saves, or bulk-generates them.
Generates AI content for selected flashcards using Claude, ChatGPT, Gemini, or DeepSeek, saving custom-prompted resultsβdefinitions, translations, example sentencesβdirectly into chosen fields via your own API key.
Backs up add-on IDs via a synced deck and local add-on folders to WebDAV for restoration, optionally syncing selected decks to a self-hosted MCP knowledge base.
Study with Claude, or any MCP client, instead of clicking through Anki's UI. This add-on runs an MCP server inside Anki itself, no AnkiConnect, no Node.js, no PyPI downloads at runtime. Install it, and your MCP client can create cards, quiz you, and analyze your retention in plain conversation.
Examples of what you can ask:
Everything runs locally. Your collection never leaves your machine except through whatever MCP client you're already using.
Setup
Once enabled, the MCP server starts automatically whenever you open an Anki profile. Tools β Add-ons β anki-mcp β Config opens a settings dialog with a Client Setup tab: one-click copy for the Claude Code command, one-click export of the Claude Desktop extension, and the raw connection URL for any other MCP client.
Full docs, tool list, and source: https://github.com/luiz-santos-it/anki-mcp-addon
Talk to your Anki collection. Point Claude (or any MCP client) at your flashcards and study, edit, and analyze your deck in plain conversation. No AnkiConnect, no Node.js, no external dependencies. It's a small Python add-on that runs an MCP server inside Anki itself.
Anki is powerful but manual: browsing, tagging, and reviewing all happen through the desktop UI. This add-on turns your collection into something an LLM can actually work with, so you can ask for things instead of clicking through them:
hard, move them into a Review deck."Everything runs locally. Your collection never leaves your machine except through whatever MCP client you're already using.
593632040%APPDATA%\Anki2\addons21\ on Windows)__init__.py and manifest.json) into that add-ons directoryEither way, the MCP server starts automatically when you open a profile. It listens on http://127.0.0.1:8766.
Tools β Add-ons β anki-mcp β Config opens a settings dialog. Change the port and click "Save and restart MCP server" (restarts the add-on's server, not Anki); no need to restart Anki. "Restore default" resets the field back to 8766.
Tools β Add-ons β anki-mcp β Config β Client Setup tab has one-click copy for the Claude Code command and the manual Claude Desktop config, plus an Export Extension... button for the Claude Desktop .mcpb, all using whatever port you've actually got configured. The steps below are the same actions done by hand, for reference or scripting.
claude mcp add anki --transport sse http://127.0.0.1:8766/sse
Restart Claude Code. Anki must be open whenever you use it.
Claude Desktop installs local MCP servers as Desktop Extensions (.mcpb files) rather than through manual JSON config. Easiest path: Tools β Add-ons β anki-mcp β Config β Client Setup tab β Export Extension..., save anki-mcp.mcpb anywhere.
Then in Claude Desktop: Settings β Extensions β Install Extension..., pick that file. It prompts for the Anki MCP server URL (defaults to http://127.0.0.1:8766/sse, only change it if you changed the add-on's port). Anki must be open.
The exported file is a pre-built copy of desktop-extension.mcpb, checked into this repo. mcp-remote is bundled as a real dependency (not resolved via npx at runtime, which isn't reliably on PATH inside Claude Desktop's Node environment), so a rebuild needs npm install first. If you change desktop-extension/manifest.json, desktop-extension/server/index.js, or desktop-extension/server/package.json, rebuild and commit it:
cd desktop-extension/server
npm install
cd ..
npx -y @anthropic-ai/mcpb pack . ../desktop-extension.mcpb
Add to claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json). A bare url isn't supported in older versions, so bridge through mcp-remote:
{
"mcpServers": {
"anki": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://127.0.0.1:8766/sse"]
}
}
}
If Claude Desktop can't find npx on its own, use the absolute path (e.g. C:\\nvm4w\\nodejs\\npx.cmd on Windows) instead of "npx".
Note for Microsoft Store installs of Claude Desktop: the app reads its config from the MSIX-virtualized copy at %LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude\claude_desktop_config.json β edits to %APPDATA%\Claude\claude_desktop_config.json are silently ignored. The Extension install path above avoids this entirely.
Use SSE transport URL: http://127.0.0.1:8766/sse
Refer to each client's MCP documentation for where to configure SSE servers.
Notes
| Tool | Description |
|---|---|
create_notes |
Create Basic or Cloze notes. Supports batch. |
search_notes |
Search with Anki browser syntax. Returns up to limit notes (default 50). |
update_note |
Edit note fields in place by note ID. Preserves scheduling data. |
add_tags / remove_tags |
Tag notes by ID. Supports :: hierarchy. |
delete_notes |
Delete notes by ID (also deletes associated cards). |
move_notes |
Move notes to another deck. |
Decks
| Tool | Description |
|---|---|
create_deck |
Create deck or subdeck (Parent::Child::Grandchild). |
list_decks |
List all decks with due/new/learn counts. |
delete_decks |
Delete decks by name. |
Study
| Tool | Description |
|---|---|
get_due_cards |
Get cards due for review (default limit 20, max 100). |
submit_answer |
Record answer for a card: 1=Again, 2=Hard, 3=Good, 4=Easy. |
reschedule_cards |
Postpone cards by N days. |
suspend_cards |
Suspend or unsuspend cards. |
forget_cards |
Reset cards to new state. Preserves note content and tags. |
Insights & sync
| Tool | Description |
|---|---|
get_insights |
Retention stats, overdue count, mature/young cards for a deck or all decks. |
sync |
Trigger AnkiWeb sync. |
pip install pytest
pytest
Tests run without Anki. The aqt and anki modules are mocked via tests/conftest.py.
python scripts/build_ankiaddon.py
Produces anki-mcp.ankiaddon (flat zip, no wrapping folder) for upload to the AnkiWeb listing. Must be re-run and re-uploaded whenever a runtime file changes, including desktop-extension.mcpb.
MIT