# Anki MCP Server — MCP server card for AI agents

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

Registry name: `ai.ankimcp/anki-mcp-server` · category: Productivity and workspace · version 0.27.0 · updated 2026-10-04

## Connect
- npm (stdio): `npx -y @ankimcp/anki-mcp-server`

## Facts
- Repository: https://github.com/ankimcp/anki-mcp-server (567 stars)
- Website: https://ankimcp.ai

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/ai-ankimcp-anki-mcp-server/


## Anki MCP Server: let your AI assistant make and review flashcards

Anki MCP Server lets an AI assistant work with the Anki flashcard app on your computer. It can make new cards, quiz you on cards that are due and record how well you knew each one, like a private tutor. Your cards stay in your own Anki; the server sends nothing to its makers.

### Where to use it
- Study a deck in conversation: Say "help me review my Spanish deck". The assistant shows each due card, checks your answer, explains mistakes and records your rating in Anki.
- Make cards from what you read: Paste notes, a lecture summary or a word list and ask for cards. The assistant adds them to the deck you name, up to 100 at a time.
- Language cards with right-to-left text: For Arabic or Hebrew vocabulary, the assistant can create a card style that writes right to left and then fill it with words.
- Add a picture to a card: Point the assistant at an image on your computer or a web address, and it puts the picture on the front of the selected card.
- Let the assistant look but not edit: Start it in read-only mode to browse decks and search notes without risk of the assistant changing or deleting cards.
- A weekly study check-in: Ask once a week how your reviews went, which decks fall behind and how long your study streak is, then plan the next week. (idea, not from the official pages)

### How to start
- In Anki, install the AnkiConnect add-on with code 2055492159 and restart Anki. You need Node.js 22.12.0 or newer.
- Add the server to your assistant. In Claude Code it is one command.

```
claude mcp add --transport stdio anki -- npx -y @ankimcp/anki-mcp-server --stdio
```

- Keep Anki open and ask the assistant to list your decks.

### License
The server's code is free under the MIT license, also for paid work. Running it on your own computer costs nothing; only the optional remote tunnel has paid plans.

### Good to know
- The Anki desktop app must be open on the same computer, with the AnkiConnect add-on installed.
- The assistant can delete notes and all their cards, but only when the call confirms the deletion on purpose.
- Edits fail without a warning if the same note is open in Anki's card browser. Close the browser window first.
- The image tool can read media files from your computer and download from web addresses; private network addresses are blocked.
- The ngrok option makes your Anki reachable by anyone who has the link; the makers recommend their signed-in tunnel instead.

Checked 2026-11-10 against: https://github.com/ankimcp/anki-mcp-server/blob/d7d65125e8469c63d84b7670ad645f997825ff3f/README.md, https://github.com/ankimcp/anki-mcp-server/blob/d7d65125e8469c63d84b7670ad645f997825ff3f/LICENSE, https://github.com/ankimcp/anki-mcp-server/blob/d7d65125e8469c63d84b7670ad645f997825ff3f/package.json, https://github.com/ankimcp/anki-mcp-server/blob/d7d65125e8469c63d84b7670ad645f997825ff3f/server.json, https://github.com/ankimcp/anki-mcp-server/blob/d7d65125e8469c63d84b7670ad645f997825ff3f/src/mcp/primitives/essential/index.ts, https://github.com/ankimcp/anki-mcp-server/blob/d7d65125e8469c63d84b7670ad645f997825ff3f/src/mcp/primitives/essential/tools/delete-notes.tool.ts, https://github.com/ankimcp/anki-mcp-server/blob/d7d65125e8469c63d84b7670ad645f997825ff3f/src/mcp/primitives/essential/tools/store-media-file.tool.ts, https://registry.npmjs.org/@ankimcp/anki-mcp-server/latest, https://ankimcp.ai/, https://ankimcp.ai/pricing/, https://ankimcp.ai/privacy/, https://ankimcp.ai/docs/how-to/connect-mcp-clients/, https://ankimcp.ai/docs/how-to/connect-claude/

### Mistakes to avoid
- Don't: Rating a card Again to push it back in the schedule → Do: Use setDueDate to move the next review, or forgetCards to start the card over (Rating Again records a real lapse and permanently skews scheduling and statistics.)
- Don't: Uploading an image to storeMediaFile as base64 text → Do: Pass the file path (/Users/you/image.png) or the image's web address (Base64 is very slow and uses many tokens.)
- Don't: deleteNotes(notes=[...]) without confirmDeletion → Do: Show the person the notes first, then call deleteNotes with confirmDeletion true (The call is rejected unless confirmDeletion is true, and deletion removes all cards of the note.)
- Don't: Running the server on Node.js 18 or 20 (ERR_REQUIRE_ESM) → Do: Install Node.js 22.12.0 or newer (The server needs Node.js 22.12.0 or newer.)
- Don't: Tags or decks named freely without checking what exists → Do: Call getTags and listDecks first (The README says to list tags first to avoid duplicates.)

### Questions
- Does it work without Anki open? No. The Anki desktop app has to be open, because the server works on your real collection.
- Does it cost money? Not on your own computer. Only the optional tunnel for web or phone assistants has a free tier and paid plans.
- Should I use this package or the AnkiMCP add-on? The makers suggest the add-on for most setups; use this package when your client starts a local server over stdio or for the Claude Desktop bundle.
- Does the server collect my data? No. It runs on your computer, collects no usage data and only talks to the AnkiConnect address you set.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
