Anki MCP Server

@captain-blue210

About Anki MCP Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "anki": {
      "command": "node",
      "args": [
        "path/to/anki-mcp-server/dist/index.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Anki MCP Server?

An MCP (Model Context Protocol) server for Claude Desktop that connects to Anki via AnkiConnect and retrieves leech-tagged cards for AI analysis.

How to use Anki MCP Server?

Install Anki with the AnkiConnect add‑on, clone the repository, install dependencies (npm install), build (npm run build), configure the .env file (optional), run npm start, and add the server to Claude Desktop’s claude_desktop_config.json. Use tools such as get_leech_cards and tag_reviewed_cards via Claude.

Key features of Anki MCP Server

Connects to Anki via the AnkiConnect API
Retrieves cards tagged as “leech”
Adds date‑stamped “reviewed” tags to cards
Provides comprehensive card data for Claude analysis
Supports mock mode for testing without affecting real data

Use cases of Anki MCP Server

Analyze leech cards to uncover study weaknesses
Tag reviewed cards to track progress with Claude
Test Claude integrations safely using mock mode

FAQ from Anki MCP Server

How does Anki MCP Server connect to Anki?

It uses the AnkiConnect add‑on, which must be installed in Anki, and communicates via HTTP (default http://localhost:8765).

What are the prerequisites for Anki MCP Server?

Anki running with the AnkiConnect add‑on, Node.js, and npm.

Can I test the server without affecting my real Anki data?

Yes. Set ANKI_MOCK_MODE=true in the .env file or use the provided .env.test configuration and run npm run start:test. All operations are simulated.

What if I get connection errors when starting the server?

If localhost fails, find your computer’s local IP address (e.g., 192.168.x.x), update ANKI_CONNECT_URL to http://YOUR_LOCAL_IP:8765, and ensure AnkiConnect allows connections from that IP.

What tools does Anki MCP Server expose to Claude?

Two tools: get_leech_cards (with optional detailed and count parameters) and tag_reviewed_cards (with required card_ids and optional custom_tag_prefix).

Frequently asked questions

How does Anki MCP Server connect to Anki?

It uses the AnkiConnect add‑on, which must be installed in Anki, and communicates via HTTP (default `http://localhost:8765`).

What are the prerequisites for Anki MCP Server?

Anki running with the AnkiConnect add‑on, Node.js, and npm.

Can I test the server without affecting my real Anki data?

Yes. Set `ANKI_MOCK_MODE=true` in the `.env` file or use the provided `.env.test` configuration and run `npm run start:test`. All operations are simulated.

What if I get connection errors when starting the server?

If `localhost` fails, find your computer’s local IP address (e.g., `192.168.x.x`), update `ANKI_CONNECT_URL` to `http://YOUR_LOCAL_IP:8765`, and ensure AnkiConnect allows connections from that IP.

What tools does Anki MCP Server expose to Claude?

Two tools: `get_leech_cards` (with optional `detailed` and `count` parameters) and `tag_reviewed_cards` (with required `card_ids` and optional `custom_tag_prefix`).