Skip to main content
Glama

anki-mcp

An MCP (Model Context Protocol) server that enables Claude Code to create and manage Anki flashcards. Create flashcards during your coding sessions and review them later on mobile via AnkiWeb sync.

Why

Learning happens during work, but knowledge fades without review. This tool lets you capture learnings as flashcards without leaving your terminal, then review them on your phone using Anki's spaced repetition system.

Related MCP server: MCP-AnkiConnect

Features

  • Create single or batch flashcards with tags

  • Create and list decks (supports nested decks via :: syntax)

  • Search cards using Anki's query syntax

  • Get deck statistics (new, due, total cards)

  • Sync to AnkiWeb for mobile access

  • Check AnkiConnect connection status

Prerequisites

  • macOS (tested on macOS 14+)

  • Python 3.12+

  • uv package manager

  • Claude Code CLI

Setup

1. Install Anki Desktop

brew install --cask anki

2. Install AnkiConnect Add-on

  1. Open Anki

  2. Go to Tools > Add-ons > Get Add-ons...

  3. Enter code: 2055492159

  4. Click OK

  5. Restart Anki

3. Configure AnkiConnect Port (if needed)

AnkiConnect defaults to port 8765. If that port is in use, change it:

  1. Go to Tools > Add-ons

  2. Select AnkiConnect > Config

  3. Change "webBindPort": 8765 to another port (e.g., 8766)

  4. Restart Anki

The config file is located at:

~/Library/Application Support/Anki2/addons21/2055492159/config.json

4. Clone and Install anki-mcp

git clone https://github.com/hbd/anki-mcp.git
cd anki-mcp
uv sync

5. Configure Claude Code

Add to your .mcp.json (project-level) or ~/.claude/settings.json (global):

{
  "mcpServers": {
    "anki": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/anki-mcp",
        "fastmcp",
        "run",
        "server.py"
      ],
      "env": {
        "ANKI_CONNECT_URL": "http://localhost:8766"
      }
    }
  }
}

Update the --directory path and ANKI_CONNECT_URL port to match your setup.

6. Restart Claude Code

The MCP server will be available after restart.

7. Configure AnkiWeb Sync (for mobile access)

  1. Create an account at ankiweb.net

  2. In Anki desktop: Tools > Preferences > Syncing

  3. Sign in with your AnkiWeb credentials

  4. Install AnkiMobile (iOS, paid) or AnkiDroid (Android, free)

  5. Sign in to the mobile app with the same account

Usage

Once configured, you can use natural language in Claude Code:

"Create a flashcard about Python decorators"
"Add these concepts to my Programming deck"
"Sync my cards to AnkiWeb"
"How many cards are due today?"

Available Tools

Tool

Description

list_decks

List all Anki decks

create_deck

Create a new deck

add_flashcard

Add a single flashcard

add_flashcards

Add multiple flashcards in batch

search_cards

Search using Anki query syntax

get_deck_stats

Get deck statistics

sync_anki

Trigger AnkiWeb sync

anki_connection_status

Check if AnkiConnect is responding

Search Query Examples

deck:Default           # Cards in Default deck
tag:python             # Cards with python tag
is:new                 # New cards not yet studied
is:due                 # Cards due for review
added:1                # Cards added today
front:*decorator*      # Cards with "decorator" in front

Architecture

Claude Code --> MCP Server --> AnkiConnect --> Anki Desktop
                                                    |
                                               AnkiWeb (cloud)
                                                    |
                                            Mobile App (iOS/Android)

Requirements

  • Anki desktop must be running for the MCP server to work

  • AnkiConnect add-on must be installed and enabled

  • Sync is not automatic - use the sync_anki tool or sync manually in Anki

Troubleshooting

"AnkiConnect not responding"

  • Ensure Anki desktop is running

  • Check that AnkiConnect is installed (Tools > Add-ons)

  • Verify the port in your config matches AnkiConnect's port

Port conflict

If port 8765 is in use:

  1. Check what's using it: lsof -i :8765

  2. Change AnkiConnect to a different port (see step 3 above)

  3. Update ANKI_CONNECT_URL in your MCP config

Sync fails with "auth not configured"

Sign in to AnkiWeb in Anki desktop (Tools > Preferences > Syncing).

License

MIT

Available Tools

8 tools
add_flashcardA

Add a new flashcard to Anki.

Args: front: The front/question side of the card (supports HTML/markdown) back: The back/answer side of the card (supports HTML/markdown) deck_name: The deck to add the card to (default: 'Default') tags: Optional list of tags for the card

Returns: The note ID of the created card, or None if duplicate

Inputs: front (required), back (required), deck_name, tags. Returns: result

add_flashcardsA

Add multiple flashcards to Anki in a single operation.

Args: cards: List of dicts with 'front' and 'back' keys deck_name: The deck to add cards to (default: 'Default') tags: Optional list of tags for all cards

Returns: List of note IDs (None for duplicates)

Example: add_flashcards([ {"front": "What is Python?", "back": "A programming language"}, {"front": "What is FastMCP?", "back": "A Python framework for MCP servers"}, ], deck_name="Programming", tags=["python", "mcp"])

Inputs: cards (required), deck_name, tags. Returns: result

anki_connection_statusA

Check if AnkiConnect is responding and get version info.

Returns: Dict with connection status and AnkiConnect version

Inputs: no named parameters. Returns: object

create_deckA

Create a new deck in Anki.

Args: deck_name: Name of the deck to create. Use '::' for nested decks (e.g., 'Parent::Child')

Returns: The deck ID of the created deck

Inputs: deck_name (required). Returns: result

get_deck_statsA

Get statistics for a deck including due cards count.

Args: deck_name: Name of the deck to get stats for

Returns: Dict with new_count, learn_count, review_count

Inputs: deck_name. Returns: object

list_decksB

List all available Anki decks.

Inputs: no named parameters. Returns: result

search_cardsA

Search for cards in Anki using Anki's search syntax.

Args: query: Anki search query (e.g., 'deck:Default', 'tag:python', 'front:async') limit: Maximum number of results to return

Returns: List of cards with their fields and info

Common search operators: - deck:DeckName - cards in a specific deck - tag:tagname - cards with a specific tag - is:due - cards that are due for review - is:new - new cards not yet studied - added:1 - cards added today - front:text - search front field

Inputs: query (required), limit. Returns: result

sync_ankiA

Trigger Anki to sync with AnkiWeb.

This syncs your local Anki collection with the cloud, making cards available on mobile devices.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools have distinct purposes with clear boundaries: add_flashcard vs add_flashcards for single vs batch operations, deck management vs card operations, and connection/sync functions. Minor potential confusion exists between list_decks and get_deck_stats as both relate to deck information, but their specific functions are differentiated in descriptions.

    Naming Consistency4/5

    Tools follow a consistent snake_case pattern throughout. Most use verb_noun structure (add_flashcard, create_deck, search_cards), but anki_connection_status and sync_anki deviate slightly by including 'anki' prefix rather than pure verb_noun. This minor inconsistency prevents a perfect score.

    Tool Count5/5

    Eight tools is well-scoped for an Anki integration server. This covers core flashcard operations (add, search), deck management (create, list, stats), and essential utilities (connection check, sync). Each tool has clear purpose without bloat, fitting typical MCP server tool counts.

    Completeness4/5

    The toolset provides strong coverage for basic Anki operations: creating and searching cards, managing decks, and syncing. Minor gaps exist in card lifecycle management - there are no tools to update/delete cards or modify existing decks, which could limit agent workflows. However, core creation and retrieval functions are well-covered.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      An MCP server that enables AI assistants like Claude to interact with Anki flashcard decks, allowing users to create, manage, and update flashcards through natural language conversations.
      9
      45
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      An MCP server that enables AI assistants to interact with the Anki flashcard application for studying, deck management, and note creation. It supports natural language interaction for reviewing cards, searching content, and managing media files across local and remote environments.
      1,222 npm
      570
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables AI assistants to seamlessly manage Anki flashcards, decks, and templates through the AnkiConnect API. It supports intelligent querying, batch note creation, and detailed study progress analysis using natural language.
      4
      MIT