GitHub - scorzeth/anki-mcp-server: An MCP server for Anki (original) (raw)

Anki MCP Server

An MCP server implementation that connects to a locally running Anki, providing card review and creation.

This server is designed to work with the Anki desktop app and the Anki-Connect add-on.

Make sure you have the add-on installed before using.

Resources

• anki://search/deckcurrent
  • Returns all cards from current deck
  • Equivalent of deck:current in Anki
• anki://search/isdue
  • Returns cards in review and learning waiting to be studied
  • Equivalent of is:due in Anki
• anki://search/isnew
  • Returns all unseen cards
  • Equivalent of is:new in Anki

Tools

• update_cards
  • Marks cards with given card IDs as answered and gives them an ease score between 1 (Again) and 4 (Easy)
  • Inputs:
    * answers (array): Array of objects with cardId (number) and ease (number) fields
• add_card
  • Creates a new card in the Default Anki deck
  • Inputs:
    * front (string): Front of card
    * back (string): Back of card
• get_due_cards
  • Returns n number of cards currently due for review
  • Inputs:
    * num (number): Number of cards
• get_new_cards
  • Returns n number of cards from new
  • Inputs:
    * num (number): Number of cards

Development

Install dependencies:

Build the server:

For development with auto-rebuild:

Configuration

To use with Claude Desktop, add the server config:

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

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

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

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