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

Clone this repository:

git clone https://github.com/yourusername/clanki.git
cd clanki

Install dependencies:

npm install

Build the project:

npm run build

Setup

Make sure Anki is running and the AnkiConnect plugin is installed and enabled
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:

Make changes to src/index.ts
Rebuild with npm run build
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