anki-mcp MCP Server

What is anki-mcp?

anki-mcp is a TypeScript-based MCP server that integrates with Anki via the AnkiConnect plugin. It allows MCP clients (such as Claude Desktop) to list decks and note models, retrieve model details, and create notes in Anki. It is intended for users who want to manage their Anki flashcards programmatically through the Model Context Protocol.

How to use anki-mcp?

Install dependencies with npm install, build with npm run build, then add the server configuration to your MCP client’s config file (e.g., Claude Desktop’s claude_desktop_config.json). Once connected, the client can call the server’s tools (such as listDecks, addNote) to interact with Anki.

Key features of anki-mcp

• Lists Anki decks and note models via URIs
• Creates single or multiple notes in bulk
• Retrieves detailed information about a specific note model
• Provides JSON representations of Anki objects
• Integrates with the AnkiConnect plugin (no separate API key required)

Use cases of anki-mcp

• Add new flashcards to a specific Anki deck with custom fields and tags
• Retrieve all deck names to verify or select a target deck
• Fetch note model details to understand field structure before adding notes
• Create multiple notes at once for batch import of study material

FAQ from anki-mcp

Does anki-mcp require Anki to be running?

Yes, it requires Anki to be active with the AnkiConnect plugin installed and enabled.

How do I install and configure anki-mcp?

Run npm install and npm run build in the project directory, then add a server entry in your MCP client’s config file (see the README for example JSON).

What tools does anki-mcp provide?

It provides listDecks, listModels, getModel, addNote, and addNotes for managing Anki notes.

Can I create multiple notes at once?

Yes, the addNotes tool accepts multiple note definitions in a single call for bulk creation.

Does anki-mcp use any authentication or special transport?

No authentication is required. The server communicates over stdio, the standard MCP transport.