Yanki MCP Server ( Yet Another Anki MCP Server )

What is Yanki MCP Server?

Yanki MCP Server is a Model Context Protocol server that connects to a local Anki desktop app via the Anki-Connect add-on. It enables AI assistants to review and create flashcards, automatically organizing new cards into date‑structured decks. It is a fork of scorzeth/anki-mcp-server with added date‑based organization.

How to use Yanki MCP Server?

Run without installation via npx yanki-mcp-server or install globally with npm install -g yanki-mcp-server and run yanki-server. To use with Claude Desktop, add a configuration entry pointing to the server and optionally set the DECK environment variable to change the base deck name (default: "00_Inbox"). All communication happens over MCP stdio.

Key features of Yanki MCP Server?

• Connects to a locally running Anki via Anki-Connect
• Provides resources for searching current deck, due cards, and new cards
• Tools to add cards with date‑structured deck names (DECK::YYYY::MM::DD)
• Tools to update cards with ease scores (1 = Again, 4 = Easy)
• Tools to retrieve due or new cards by count
• Zero configuration when using default deck; fully customizable via DECK env var

Use cases of Yanki MCP Server?

• Automatically organize new flashcards by creation date instead of manual categories
• Review due cards from the current day without leaving your AI assistant
• Add quick notes or facts that get timestamped and placed into a daily deck
• Study newly created cards from a specific date range to reinforce recent learning
• Integrate spaced repetition review into an MCP‑compatible client workflow

FAQ from Yanki MCP Server

What does Yanki MCP Server require to run?

It requires the Anki desktop app and the Anki-Connect add‑on to be installed and running locally.

How are new cards organized?

New cards are added to a deck with the format DECK::YYYY::MM::DD, where DECK is the base name (default "00_Inbox") and the rest is the current date.

Can I change the base deck name?

Yes, set the DECK environment variable in your MCP server configuration to any custom name.

How do I debug this server?

Use the included MCP Inspector by running npm run inspector after cloning the repository.

What transport does this server use?

It communicates over MCP stdio (standard input/output). No authentication is required.