anki-mcp-server

The Anki MCP Server acts as a bridge to the Anki spaced repetition software through the Anki-Connect add-on. It enables MCP-compatible clients, such as AI assistants or other applications, to interact with Anki collections by managing decks, cards, and notes. The server provides a comprehensive set of Anki actions as MCP tools, facilitating communication with the local Anki-Connect instance. Users can perform various operations, including deck management, card management, note management, and model management, as well as miscellaneous actions like requesting permission, getting version information, and syncing with AnkiWeb. The server requires Anki and the Anki-Connect add-on to be installed and running, along with a compatible Python version and the 'uv' tool for managing Python environments.

Features

• Comprehensive set of Anki actions as MCP tools
• Manages communication with Anki-Connect
• Deck, card, note, and model management
• Miscellaneous actions like permission requests and syncing
• Integration with MCP-compatible clients

MCP Tools

• {'anki_deck_names': 'Gets the complete list of deck names.'}
• {'anki_find_cards': 'Finds cards using an Anki search query.'}
• {'anki_add_note': 'Creates a new Anki note with specified details.'}
• {'anki_model_names': 'Gets the list of model (note type) names.'}
• {'anki_request_permission': 'Requests permission to use the Anki-Connect API.'}

Usage with Different Platforms

Direct Execution

bash
uv run python main.py

Development Mode

bash
uv run mcp dev main.py

Install for Claude Desktop

bash
uv run mcp install main.py --name "Anki Bridge"