What is Clanki

Clanki is an MCP server designed to connect AI assistants like Claude with Anki flashcard decks, enabling seamless interaction through the Model Context Protocol.

Use cases

Use cases for Clanki include creating study decks for various subjects, generating flashcards for language vocabulary, and managing complex information through cloze deletion cards.

How to use

To use Clanki, install Anki and the AnkiConnect plugin, clone the Clanki repository, install dependencies, build the project, and configure Claude to connect to the Clanki server.

Key features

Key features include creating and managing Anki decks, creating basic and cloze deletion flashcards, updating existing cards, managing tags, and viewing deck contents and card information, with full integration with AnkiConnect.

Where to use

Clanki can be used in educational settings, language learning, and any scenario where flashcards are utilized for effective memorization and learning.

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