Anki MCP Server
A Model Context Protocol (MCP) server that enables LLMs to interact with Anki flashcard software through the AnkiConnect API.
Features
- Create new decks in Anki
- Add notes to existing decks
- List available decks and note models
- Search for notes using Anki's search syntax
- Get detailed information about note models and their fields
- Bulk add multiple notes at once
Prerequisites
- Node.js (v14 or later)
- Anki with the AnkiConnect add-on installed
- A Model Context Protocol compatible client (such as Claude with Anthropic MCP support)
Installation
-
Make sure you have Anki installed with the AnkiConnect add-on
- Install AnkiConnect by going to Tools > Add-ons > Get Add-ons and entering code:
2055492159
- Install AnkiConnect by going to Tools > Add-ons > Get Add-ons and entering code:
-
Clone this repository:
git clone https://github.com/yourusername/anki-mcp-server.git cd anki-mcp-server -
Install dependencies:
npm install -
Build the project:
npm run build
Usage
-
Make sure Anki is running on your computer with AnkiConnect enabled
-
Start the MCP server:
npm start -
Connect your MCP client (e.g., Claude) to this server
Available Tools
The server provides the following tools to MCP clients:
- listDecks: Get a list of all decks in Anki
- listModels: Get a list of all note models/types in Anki
- createDeck: Create a new deck in Anki
- getModel: Get details about a specific note model/type
- addNote: Add a single note to a deck
- addNotes: Add multiple notes at once
- searchNotes: Search for notes using Anki's search syntax
Examples
Create a New Deck
{
"name": "createDeck",
"arguments": {
"name": "My New Deck"
}
}
Add a Note
{
"name": "addNote",
"arguments": {
"deckName": "My New Deck",
"modelName": "Basic",
"fields": {
"Front": "What is the capital of France?",
"Back": "Paris"
},
"tags": ["geography", "europe"]
}
}
Search Notes
{
"name": "searchNotes",
"arguments": {
"query": "deck:\"My New Deck\" tag:geography"
}
}
Configuration
The server configuration is in the config object in src/index.ts. You can modify:
ankiConnectUrl: URL for the AnkiConnect API (default:http://localhost:8765)apiVersion: API version for AnkiConnect (default:6)defaultDeckName: Default deck to use if none specified (default:Default)
Troubleshooting
-
Cannot connect to Anki
- Make sure Anki is running
- Check that AnkiConnect add-on is installed and working
- Verify that the AnkiConnect URL is correct (default: http://localhost:8765)
-
Permission issues with AnkiConnect
- AnkiConnect may prompt for permission when the server tries to add cards. Look for a popup in Anki.
License
MIT License