Anki MCP Server
Provides tools for managing Anki decks and cards, including creating decks, adding basic and cloze cards, batch card operations, and retrieving review queues through the Anki API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Anki MCP Server add a basic card to my Spanish deck with front 'hola' and back 'hello'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Anki MCP Server
An MCP (Model Context Protocol) server that provides tools for interacting with the Anki API. This server allows AI assistants to manage Anki decks and cards through simple tool calls.
Features
List Anki decks with pagination
Create new decks
Add cards (basic and cloze types)
Batch add multiple cards
Get review queue with filtering options
Support for dynamically loading additional tools from an external API
Related MCP server: Anki MCP Server
Available Tools
listDecks - List all Anki decks with optional pagination
createDeck - Create a new Anki deck
addCardsBatch - Add multiple cards to a deck in batch
addBasicCard - Add a single basic card to a deck
addClozeCard - Add a cloze deletion card to a deck
getReviewQueue - Get cards due for review with filtering options
Installation
npm install -g @x-mcp/anki
# or
pnpm add -g @x-mcp/ankiDevelopment
# Install dependencies
pnpm install
# Build the project
pnpm run build
# Run in development mode (auto-restart on changes)
pnpm run dev
# Run the server
pnpm start
# Lint and format code
pnpm run lint
pnpm run formatConfiguration
MCP Client Configuration
Add this to your MCP client settings:
{
"mcpServers": {
"anki-mcp": {
"command": "npx",
"args": ["-y", "@x-mcp/anki@latest"],
"env": {
"ANKI_BASE_URL": "http://localhost:3000", // Anki API base URL
"ANKI_API_KEY": "ank_YOUR_API_KEY_HERE" // Your Anki API key
}
}
}
}Environment Variables
Create a .env file:
# Required: Anki API configuration
ANKI_BASE_URL=http://localhost:3000/api/v1
ANKI_API_KEY=ank_YOUR_API_KEY_HERE
# Optional: External tools API configuration
API_URL=https://your-api-endpoint.com/tools
API_KEY=your-api-keyUsage Example
Once configured, the AI assistant can use commands like:
"List all my Anki decks"
"Create a new deck called 'Spanish Vocabulary'"
"Add a card with front 'Hello' and back 'Hola' to my Spanish deck"
"Show me cards due for review"
Each tool makes direct HTTP requests to the Anki API and returns the response data.
API Requirements
The tools interact with an Anki API that should have the following endpoints:
GET /api/v1/decks- List decksPOST /api/v1/decks- Create deckPOST /api/v1/decks/{deckId}/cards/batch- Add cardsGET /api/v1/study/queue- Get review queue
License
MIT
Available Tools
6 toolsaddBasicCardB
Add a single basic card to a deck
Inputs: back (required), front (required), deckId (required), tags.
addCardsBatchB
Add multiple cards to a deck in batch
Inputs: cards (required), deckId (required).
addClozeCardB
Add a cloze deletion card to a deck
Inputs: back (required), front (required), deckId (required), clozeText (required), +1 more.
createDeckB
Create a new Anki deck
Inputs: name (required), description (required), isPublic.
getReviewQueueB
Get cards due for review with filtering options
Inputs: limit, deckId, includeNew, includeReview, +1 more.
listDecksB
List all Anki decks with optional pagination
Inputs: limit, offset.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Tools are mostly distinct: addBasicCard, addClozeCard, and addCardsBatch target different card types or batch operations; createDeck, listDecks, and getReviewQueue are clearly separate. However, addCardsBatch could overlap with addBasicCard or addClozeCard if used for multiple cards of a specific type.
All tools follow a verb_noun pattern with imperative verbs (add, create, get, list). Minor inconsistencies: 'CardsBatch' uses plural and compound noun, while others use singular (BasicCard, ClozeCard). Capitalization is consistent with CamelCase.
With 6 tools, the server is well-scoped for basic Anki operations: deck creation, card addition (basic, cloze, batch), deck listing, and review queue retrieval. The number is appropriate for a focused subset.
Significant gaps exist: no update or delete operations for cards or decks, no ability to list cards within a deck, and no support for managing models or tags. Agents can create and add but cannot modify or remove content.
Maintenance
Related MCP Connectors
Turn text, files, URLs, or photos into Anki flashcard decks from your AI assistant.
Language flashcards in your AI assistant: build decks, edit cards and review what's due in the chat.
Language flashcards: list your decks, read cards and review progress, save new decks from a chat.
Build and study spaced-repetition flashcards with your agent.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants like Claude to interact with Anki flashcard decks through AnkiConnect. Supports creating and managing decks, basic and cloze deletion cards, searching existing cards, and organizing content with tags.-
- AlicenseNot gradedqualityDmaintenanceEnables interaction with the Anki desktop flashcard application through the Anki-Connect plugin. Supports managing decks, cards, notes, and models, allowing AI assistants to create and query flashcards through natural language.10 npm1ISC
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Anki flashcard collections by creating, searching, and updating cards through a standardized interface. It supports media handling, batch operations, and review scheduling via the AnkiConnect add-on.62MIT
- AlicenseAqualityDmaintenanceEnables AI tools to manage Anki flashcards, including deck management, card search, creation, editing, deletion, and statistics.1030 npm3Apache 2.0