Clanki 2.0: Your AI's Supercharged Bridge to Anki! 🚀

What is Clanki 2.0?

Clanki 2.0 is a Model Context Protocol (MCP) server that gives AI assistants, like Claude, direct and intelligent access to your Anki desktop flashcard collection. It integrates with Anki via the AnkiConnect plugin and is designed for learners who want to automate or enhance their study workflow through an AI.

How to use Clanki 2.0?

Ensure Anki is running with AnkiConnect installed, and Node.js 18+ is available. Clone the repository, run npm install and npm run build. Then add the server to your MCP client’s configuration (e.g., claude_desktop_config.json) with "command": "node" and "args": ["/absolute/path/to/clanki/build/index.js"]. Start your AI assistant to begin using the tools.

Key features of Clanki 2.0

• Create, delete, and get statistics for Anki decks
• Create basic and cloze‑deletion cards, including batch creation
• Update existing cards and delete notes by Note ID
• Retrieve detailed card information (status, interval, reviews, etc.)
• Suspend or unsuspend cards by Card ID or Anki query
• Search cards using flexible criteria or raw Anki query syntax

Use cases of Clanki 2.0

• Automatically creating flashcards from AI‑generated study materials
• Organizing and cleaning up decks by deleting obsolete decks or notes
• Suspending difficult cards during a study session without manual clicks
• Gathering deck statistics for progress tracking and review planning
• Batch‑creating hundreds of cards from a structured data source

FAQ from Clanki 2.0

What prerequisites are needed?

Anki desktop must be running with the AnkiConnect plugin installed. Node.js version 18 or higher is required.

How do I configure Clanki 2.0 with my AI assistant?

Edit your MCP client’s configuration file (e.g., claude_desktop_config.json) and add a "clanki" entry with "command": "node" and "args": ["/absolute/path/to/clanki/build/index.js"]. Replace the path with the absolute location of your build folder.

Can I delete whole decks using Clanki 2.0?

Yes, the delete-deck tool permanently removes an entire deck and all its cards. This action is irreversible, so use it with caution.

How do I search for specific cards?

Use the query-cards tool, which accepts many optional filters (deck, tags, card state, text content, added