mcpField
A
Anki MCP Server

Anki MCP Server

Local
github.com/johwiebeScience & Education0Updated 34w ago
Repository

About Anki MCP Server

An MCP server that connects AI assistants to Anki for managing cards, notes, and review information. It supports batch note updates, searches, card-state changes, and a resource documenting Anki search syntax.

Key features

  1. 01View decks, note types, and fields
  2. 02Add or update notes in batches
  3. 03Count reviewed cards by day
  4. 04Search notes and cards with Anki syntax
  5. 05Suspend or unsuspend cards
  6. 06Provide search syntax documentation

Use cases

  1. 01Create or update study notes in batches
  2. 02Find notes or cards matching a query
  3. 03Count cards reviewed each day
  4. 04Suspend or unsuspend selected cards

MCP support

The MCP server exposes Anki collection search and management through tools and the `anki://docs/search-syntax` resource. Anki and the AnkiConnect add-on must be running.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "anki": {
      "command": "uvx",
      "args": [
        "anki-mcp"
      ]
    }
  }
}
Run commanduvx anki-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypianki-mcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Anki MCP Server

A Model Context Protocol (MCP) server for integrating AI assistants with Anki, the popular spaced repetition flashcard software.

Features

This MCP server enables AI assistants to interact with Anki through the following tools:

Tools

  • get-collection-overview: Returns an overview of the Anki collection like available decks, available models and their fields

  • add-or-update-notes: Adds new notes or updates existing ones. Allows batch adding/updating multiple notes at once.

  • get-cards-reviewed: Get the number of cards reviewed by day

  • find-notes: Allows querying notes using the Anki searching syntax

  • find-cards: Find card IDs matching a query in Anki

  • suspend-cards: Suspend cards by their card IDs

  • unsuspend-cards: Unsuspend cards by their card IDs

Resources
  • anki://docs/search-syntax: Comprehensive reference guide for Anki's search query syntax. Includes basic operators, field searches, tags, decks, card states, properties, timing, IDs, custom data, and advanced query examples. This resource provides language-agnostic documentation useful for anyone constructing search queries with the find-notes or find-cards tools

Requirements

  • Anki must be installed and running
  • The AnkiConnect add-on must be installed in Anki and running
  • This MCP server uses uv. To install uv, follow the official instructions.

Installation

As a Claude Code plugin (recommended)

Install as a plugin to get both the MCP server and language learning skill in one step:

/plugin install anki-mcp
Manual setup for Claude Code

  1. Add the MCP server:

    claude mcp add anki -- uvx anki-mcp

  2. Optionally, copy the skill files from skills/ into your project's .claude/skills/ directory for language learning guidance.

Claude Desktop

  1. Open your Claude Desktop config file:

    • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%/Claude/claude_desktop_config.json

  2. Add anki-mcp to the mcpServers section:

    "mcpServers": {
  "anki": {
    "command": "uvx",
    "args": ["anki-mcp"]
  }
}

  3. Restart Claude Desktop.

MCP server only

For other MCP-compatible clients, run the server directly:

uvx anki-mcp

Language Learning Skill

This plugin includes a complementary skill that provides best practices for creating effective language learning flashcards. When installed as a plugin, the skill is automatically available. The skill includes:

  • Recommended workflow for card creation
  • Card quality guidelines (length, content, cloze usage)
  • Note type variety recommendations
  • Examples of good vs bad cards
  • Proficiency level guidelines (CEFR A1-C2)

The MCP server works independently of the skill, so you can use it for any Anki workflow — not just language learning.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.