spacholski1225/anki-connect-mcp

A Model Context Protocol (MCP) server that provides seamless integration with Anki through the AnkiConnect add-on. This server enables AI assistants and other MCP clients to interact with your Anki flashcard collection programmatically.
What is Anki Connect?
AnkiConnect is a powerful Anki add-on that exposes Anki's functionality through a REST API. It allows external applications to:
- Create, modify, and delete flashcards
- Manage decks and their configurations
- Control Anki's GUI programmatically
- Search and retrieve card information
- Manage tags and note types
- Perform bulk operations on cards and notes
What is MCP (Model Context Protocol)?
The Model Context Protocol is a standardized way for AI assistants to connect to external data sources and tools. This MCP server acts as a bridge between MCP clients (like Claude Desktop) and AnkiConnect, allowing AI assistants to help you manage your Anki flashcards naturally through conversation.
Features
This MCP server provides comprehensive access to AnkiConnect functionality through the following tools:
Flashcard Management
- create_flashcard() - Create new flashcards with front and back content
- add_note() - Add notes with custom fields and tags
- add_notes() - Bulk add multiple notes
- update_note_fields() - Update existing note fields
- find_notes() - Search for notes using Anki's query syntax
Deck Management
- deck_names() - Get all deck names
- deck_names_and_ids() - Get deck names with their IDs
- change_deck() - Move cards between decks
- delete_decks() - Delete decks and optionally their cards
- get_deck_config() - Retrieve deck configuration settings
Card Operations
- find_cards() - Search for cards
- cards_info() - Get detailed card information
- suspend() / unsuspend() - Suspend/unsuspend cards
- are_suspended() / are_due() - Check card status
GUI Control
- gui_deck_browser() - Open deck browser
- gui_deck_review() - Start deck review
- gui_browse() - Open card browser with search
- gui_add_cards() - Open add cards dialog
Utility Tools
- version() - Get AnkiConnect version
- get_tags() - Retrieve all tags
- multi() - Execute multiple AnkiConnect requests in batch
Prerequisites
1. Install AnkiConnect Add-on
1. Open Anki
2. Go to **Tools** → **Add-ons**
3. Click **Get Add-ons...**
4. Enter the code: 2055492159
5. Click **OK** and restart Anki
2. Configure AnkiConnect (Optional)
AnkiConnect works out of the box, but you can customize its settings:
1. Go to **Tools** → **Add-ons**
2. Select **AnkiConnect** and click **Config**
3. Modify settings if needed (default port is 8765)
4. Restart Anki after making changes
Installation
1. Clone this repository:
2. Install dependencies:
3. Build the project:
MCP Client Configuration
Claude Desktop
To use this MCP server with Claude Desktop, add the following configuration to your MCP settings file:
**Location of MCP configuration file:**
- **Windows**: %APPDATA%\Claude\claude_desktop_config.json
- **macOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
- **Linux**: ~/.config/Claude/claude_desktop_config.json
**Configuration Options:**
Option 1: Using Node.js (Local Installation)