ankimaster

Anki MCP server with learning intelligence and a source-to-cards pipeline.

Unlike other Anki MCPs that only do CRUD, ankimaster exposes your review analytics, finds your leeches and weak areas, and lets you create flashcards with full source traceability — so an LLM can pull from Notion, Obsidian, or any source and you always know where each card came from.

Prerequisites

• Anki running
• AnkiConnect addon installed (Tools > Add-ons > Get Add-ons > code 2055492159)

Installation

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "ankimaster": {
      "command": "npx",
      "args": ["ankimaster"]
    }
  }
}

From source

git clone https://github.com/gabrielrf97/ankimaster.git
cd ankimaster
npm install && npm run build

Then add it to your MCP client. For Claude Code:

claude mcp add ankimaster -- node $(pwd)/dist/index.js

For Claude Desktop, add to your config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "ankimaster": {
      "command": "node",
      "args": ["/absolute/path/to/ankimaster/dist/index.js"]
    }
  }
}

Replace /absolute/path/to/ankimaster with the actual path where you cloned the repo.

CLI options

--port <number>   AnkiConnect port (default: 8765)
--host <string>   AnkiConnect host (default: localhost)

Tools

Core (9 tools)

Learning Intelligence (5 tools)

Source-to-Cards (2 tools)

Source-to-Cards Workflow

ankimaster uses Anki's native tag system for source attribution. Every card created through create_source_cards gets tagged with:

• ankimaster — identifies cards created through this tool
• source:{type} — the source type (notion, obsidian, pdf, url, manual)
• source_id:{hash} — deterministic hash of the source URL for lookup
• source_title:{slug} — slugified source title

Example: Notion integration

With a Notion MCP also connected, the LLM can:

1. Read a Notion page via the Notion MCP
2. Call get_source_cards to check if cards already exist from that page
3. Generate flashcards from the content
4. Call create_source_cards with the Notion page URL as the source

Same pattern works for Obsidian, PDFs, web pages, or any source the LLM can access.

Security

• HTML sanitization: Card content is sanitized — <script>, <iframe>, tracking pixels, and event handlers are stripped
• Zero unnecessary deps: Only @modelcontextprotocol/sdk as a production dependency. Raw fetch() to AnkiConnect instead of third-party wrappers
• No telemetry, no external calls: Only talks to your local AnkiConnect instance

License

MIT