baraja-mcp

# Baraja MCP Server A Model Context Protocol (MCP) server that connects Claude Desktop to your local Anki instance via AnkiConnect. Enables Claude to create, manage, and search flashcards directly in your Anki decks. > **Note:** While this MCP works with any Anki collection, many features and examples are geared towards Spanish language learning. ## Features - **Health Check**: Verify Anki and AnkiConnect are running - **Deck Management**: List and create decks - **Flashcard Creation**: Add single or batch flashcards - **Cloze Deletions**: Create cloze deletion cards for sentence learning - **Search**: Find existing notes using Anki's search syntax - **Sync**: Trigger AnkiWeb synchronization - **Statistics & Analytics**: Deck stats, collection overview, study streaks, retention metrics, learning curves - **Card Management**: Suspend/unsuspend cards, update content, delete notes, move cards between decks, manage tags - **Problem Detection**: Identify struggling cards with low ease or high lapse counts - **Scheduling Control**: View due cards, reset card progress, adjust ease factors - **Spanish Helpers**: Built-in utilities for formatting Spanish vocabulary cards ## Prerequisites Before using this MCP server, you need: 1. **Anki Desktop** - Download from [ankiweb.net](https://apps.ankiweb.net/) 2. **AnkiConnect Add-on** - Install from Anki: - Open Anki - Go to Tools → Add-ons → Get Add-ons - Enter code: `2055492159` - Restart Anki 3. **Python 3.11+** - Required for running the server ### Verify AnkiConnect is Running After installing AnkiConnect, verify it's working: ```bash curl http://localhost:8765 ``` You should see: `"AnkiConnect v.6"` ## Installation ### Option 1: Install from PyPI (Recommended) The easiest way to get started. No need to clone the repository. ```bash pip install baraja-mcp ``` Or with [uv](https://docs.astral.sh/uv/): ```bash uv pip install baraja-mcp ``` ### Option 2: Install from source ```bash git clone https:…