Anki MCP Server

🚀 Anki MCP Server

An MCP (Model Context Protocol) server that connects to a locally running Anki instance, providing card review and creation capabilities.

This server is specifically designed for the Anki desktop application and the Anki-Connect plugin.

Please ensure that you have installed the plugin before use.

📚 Resources

• anki://search/deckcurrent
  • Returns all cards in the current deck.
  • Equivalent to deck:current in Anki.
• anki://search/isdue
  • Returns learning cards awaiting review.
  • Equivalent to is:due in Anki.
• anki://search/isnew
  • Returns all unseen cards.
  • Equivalent to is:new in Anki.

🛠️ Tools

• update_cards

  • Marks cards with the specified card IDs as answered and gives a difficulty rating between 1 (again) and 4 (easy).
  • Input:
    • answers (array): An array of objects containing cardId (number) and ease (number) fields.

• add_card

  • Creates a new card in the default Anki deck.
  • Input:
    • front (string): The front of the card.
    • back (string): The back of the card.

• get_due_cards

  • Returns the n cards currently awaiting review.
  • Input:
    • num (number): The number of cards.

• get_new_cards

  • Returns n cards from the new cards.
  • Input:
    • num (number): The number of cards.

💻 Development

📦 Installation

Install dependencies:

npm install

🔨 Build

Build the server:

npm run build

🔄 Development with auto-rebuild

npm run watch

⚙️ Configuration

To use with Claude Desktop, add the following configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "anki-mcp-server": {
      "command": "/path/to/anki-mcp-server/build/index.js"
    }
  }
}

🐞 Debugging

Since the MCP server communicates via stdio, debugging can be challenging. We recommend using MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access the debugging tools in a browser.