Anki MCP Server

An MCP (Model Context Protocol) server that provides tools for interacting with the Anki API. This server allows AI assistants to manage Anki decks and cards through simple tool calls.

Features

List Anki decks with pagination
Create new decks
Add cards (basic and cloze types)
Batch add multiple cards
Get review queue with filtering options
Support for dynamically loading additional tools from an external API

Available Tools

listDecks - List all Anki decks with optional pagination
createDeck - Create a new Anki deck
addCardsBatch - Add multiple cards to a deck in batch
addBasicCard - Add a single basic card to a deck
addClozeCard - Add a cloze deletion card to a deck
getReviewQueue - Get cards due for review with filtering options

Installation

npm install -g @x-mcp/anki
# or
pnpm add -g @x-mcp/anki

Development

# Install dependencies
pnpm install

# Build the project
pnpm run build

# Run in development mode (auto-restart on changes)
pnpm run dev

# Run the server
pnpm start

# Lint and format code
pnpm run lint
pnpm run format

Configuration

MCP Client Configuration

Add this to your MCP client settings:

{
  "mcpServers": {
    "anki-mcp": {
      "command": "npx",
      "args": ["-y", "@x-mcp/anki@latest"],
      "env": {
        "ANKI_BASE_URL": "http://localhost:3000", // Anki API base URL
        "ANKI_API_KEY": "ank_YOUR_API_KEY_HERE" // Your Anki API key
      }
    }
  }
}

Environment Variables

Create a .env file:

# Required: Anki API configuration
ANKI_BASE_URL=http://localhost:3000/api/v1
ANKI_API_KEY=ank_YOUR_API_KEY_HERE

# Optional: External tools API configuration
API_URL=https://your-api-endpoint.com/tools
API_KEY=your-api-key

Usage Example

Once configured, the AI assistant can use commands like:

"List all my Anki decks"
"Create a new deck called 'Spanish Vocabulary'"
"Add a card with front 'Hello' and back 'Hola' to my Spanish deck"
"Show me cards due for review"

Each tool makes direct HTTP requests to the Anki API and returns the response data.

API Requirements

The tools interact with an Anki API that should have the following endpoints:

GET /api/v1/decks - List decks
POST /api/v1/decks - Create deck
POST /api/v1/decks/{deckId}/cards/batch - Add cards
GET /api/v1/study/queue - Get review queue

License

MIT

Available Tools

listDecks - List all Anki decks with optional pagination

createDeck - Create a new Anki deck

addCardsBatch - Add multiple cards to a deck in batch

addBasicCard - Add a single basic card to a deck

addClozeCard - Add a cloze deletion card to a deck

getReviewQueue - Get cards due for review with filtering options

# Install dependencies pnpm install # Build the project pnpm run build # Run in development mode (auto-restart on changes) pnpm run dev # Run the server pnpm start # Lint and format code pnpm run lint pnpm run format

Configuration

MCP Client Configuration

Add this to your MCP client settings:

{ "mcpServers": { "anki-mcp": { "command": "npx", "args": ["-y", "@x-mcp/anki@latest"], "env": { "ANKI_BASE_URL": "http://localhost:3000", // Anki API base URL "ANKI_API_KEY": "ank_YOUR_API_KEY_HERE" // Your Anki API key } } } }

Environment Variables

Create a .env file:

# Required: Anki API configuration ANKI_BASE_URL=http://localhost:3000/api/v1 ANKI_API_KEY=ank_YOUR_API_KEY_HERE # Optional: External tools API configuration API_URL=https://your-api-endpoint.com/tools API_KEY=your-api-key

Usage Example

Once configured, the AI assistant can use commands like:

"List all my Anki decks"

"Create a new deck called 'Spanish Vocabulary'"

"Add a card with front 'Hello' and back 'Hola' to my Spanish deck"

"Show me cards due for review"

Each tool makes direct HTTP requests to the Anki API and returns the response data.