🧠 Anki MCP

Transform your Anki flashcard experience with AI! This MCP (Model Context Protocol) server bridges your Anki flashcard collection with AI assistants like Claude, enabling natural conversations about your study materials.

🚀 What Can You Do?

Imagine having an AI tutor that knows your entire flashcard collection and can:

📚 Interactive Learning

• "Quiz me on Japanese vocabulary I haven't seen in 3 days"
• "Test me on challenging cards from my medical deck"
• "Show me cards I've been struggling with recently"

✨ Smart Content Creation

• "Create flashcards about photosynthesis with diagrams"
• "Turn this PDF chapter into spaced repetition cards"
• "Generate cloze deletion cards from my lecture notes"

🔍 Powerful Analytics

• "Which topics am I struggling with most?"
• "Show me my study patterns for the last month"
• "What's my retention rate for different card types?"

🎯 Bulk Operations

• "Tag all my chemistry cards with 'exam-prep'"
• "Move cards with low retention to an intensive review deck"
• "Find and fix duplicate cards across my decks"

🎯 Features

• 🎯 Smart Tool Design: Intuitive, high-level tools designed specifically for AI agents
• 💬 Natural Conversations: Talk to Claude about your flashcards like you would a study buddy
• ⚡ Lightning Fast: Efficient operations that don't bog down your AI assistant
• 📦 Bulk Operations: Update thousands of cards at once with simple commands
• 📊 Study Insights: Deep analytics on your learning progress and patterns
• 🎨 Rich Media: Full support for images, audio, and other media in your cards
• 🔍 Powerful Search: Leverage Anki's advanced search syntax through natural language
• 🔒 Rock Solid: Fully typed TypeScript with comprehensive error handling

🛠 Technical Stack

• Node.js: Runtime environment (18+ required)
• TypeScript: Type safety and developer experience
• MCP SDK: Model Context Protocol implementation
• yanki-connect: 🙏 Fully-typed, isomorphic AnkiConnect API client
• tsup: Fast TypeScript bundler
• PNPM: Efficient package manager

Special thanks to the yanki-connect library for providing the robust AnkiConnect interface that powers this integration!

📋 Prerequisites

1. Install Anki

Download and install Anki if you haven't already.

2. Install AnkiConnect Plugin

1. Open Anki
2. Go to Tools → Add-ons
3. Click Get Add-ons...
4. Enter code: 2055492159
5. Restart Anki

📋 Version Requirements: This server requires AnkiConnect version 25.2.25.0 or newer (released 2025-02-25) for full compatibility. Most features work with older versions, but we recommend updating for the best experience.

3. Configure AnkiConnect (Optional)

AnkiConnect works out of the box, but you can customize settings:

1. Go to Tools → Add-ons
2. Select AnkiConnect and click Config
3. Default settings should work fine for most users

🚀 Quick Start

Option 1: Use with Claude Desktop (Recommended)

1. Install the package

   npm install -g @arielbk/anki-mcp
   

2. Configure Claude Desktop

   Edit your Claude Desktop configuration file:

   **mac

... View full README on GitHub