Anki Cards (Clanki)
About
Integrates with Anki flashcards to provide card creation and deck management capabilities.
Details
- Repository
- jasperket/clanki
- License
- MIT
Explore
- Create and manage Anki decks
- Create basic flashcards with front/back content
- Create cloze deletion cards
- Update existing cards and cloze deletions
- Add and manage tags
- View deck contents and card information
- Full integration with AnkiConnect
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Anki Cards (Clanki)Command (node, npx, python, etc.)nodeArguments-
Argument 1
/absolute/path/to/clanki/build/index.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Anki installed and running
- AnkiConnect plugin installed in Anki
- Node.js 16 or higher
create-deck
Creates a new Anki deck. Parameters: name (string) - Name for the new deck.
create-card
Creates a new basic flashcard in a specified deck. Parameters: deckName (string) - Name of the deck to add the card to, front (string) - Front side content of the card, back (string) - Back side content of the card, tags (optional array) - Array of tags for the card.
create-cloze-card
Creates a new cloze deletion card in a specified deck. Parameters: deckName (string) - Name of the deck to add the card to, text (string) - Text containing cloze deletions using {{c1::text}} syntax, backExtra (optional string) - Extra information to show on the back of the card, tags (optional array) - Array of tags for the card.
update-card
Updates an existing basic flashcard. Parameters: noteId (string) - ID of the note to update, front (optional string) - New front side content, back (optional string) - New back side content, tags (optional array) - New tags for the card.
update-cloze-card
Updates an existing cloze deletion card. Parameters: noteId (string) - ID of the note to update, text (optional string) - New text with cloze deletions, backExtra (optional string) - New extra information for the back, tags (optional array) - New tags for the card.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"anki cards (clanki)": {
"cwd": "string",
"env": {},
"args": [
"/absolute/path/to/clanki/build/index.js"
],
"shell": false,
"command": "node"
}
}
}Linux
{
"cwd": "string",
"env": [],
"args": [
"/absolute/path/to/clanki/build/index.js"
],
"shell": false,
"command": "node"
}Macos
{
"cwd": "string",
"env": [],
"args": [
"/absolute/path/to/clanki/build/index.js"
],
"shell": false,
"command": "node"
}Windows
{
"cwd": "string",
"env": [],
"args": [
"/absolute/path/to/clanki/build/index.js"
],
"shell": false,
"command": "node"
}
Clanki - Claude's Anki Integration
An MCP server that enables AI assistants like Claude to interact with Anki flashcard decks through the Model Context Protocol (MCP).
Features
- Create and manage Anki decks
- Create basic flashcards with front/back content
- Create cloze deletion cards
- Update existing cards and cloze deletions
- Add and manage tags
- View deck contents and card information
- Full integration with AnkiConnect
Prerequisites
- Anki installed and running
- AnkiConnect plugin installed in Anki
- Node.js 16 or higher
Installation
1. Clone this repository:
git clone https://github.com/yourusername/clanki.git
cd clanki
2. Install dependencies:
npm install
3. Build the project:
npm run build
Setup
1. Make sure Anki is running and the AnkiConnect plugin is installed and enabled
2. Configure Claude for Desktop to use the server by editing claude_desktop_config.json:
{
"mcpServers": {
"clanki": {
"command": "node",
"args": ["/absolute/path/to/clanki/build/index.js"]
}
}
}
Replace /absolute/path/to/clanki with the actual path to your clanki installation.
Available Tools
create-deck
Creates a new Anki deck
- Parameters:
- name: Name for the new deck
create-card
Creates a new basic flashcard in a specified deck
- Parameters:
- deckName: Name of the deck to add the card to
- front: Front side content of the card
- back: Back side content of the card
- tags: (Optional) Array of tags for the card
create-cloze-card
Creates a new cloze deletion card in a specified deck
- Parameters:
- deckName: Name of the deck to add the card to
- text: Text containing cloze deletions using {{c1::text}} syntax
- backExtra: (Optional) Extra information to show on the back of the card
- tags: (Optional) Array of tags for the card
update-card
Updates an existing basic flashcard
- Parameters:
- noteId: ID of the note to update
- front: (Optional) New front side content
- back: (Optional) New back side content
- tags: (Optional) New tags for the card
update-cloze-card
Updates an existing cloze deletion card
- Parameters:
- noteId: ID of the note to update
- text: (Optional) New text with cloze deletions
- backExtra: (Optional) New extra information for the back
- tags: (Optional) New tags for the card
Development
To modify or extend the server:
1. Make changes to src/index.ts
2. Rebuild with npm run build
3. Debug with npx @modelcontextprotocol/inspector node build/index.js
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Acknowledgments
- Built with the Model Context Protocol SDK
- Integrates with Anki via AnkiConnect
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
