Camdenclark Anki MCP Server

🚀 Anki-MCP Server

An MCP server integrated with Anki through the AnkiConnect plugin.

This is a TypeScript-based MCP server that integrates with Anki via the AnkiConnect plugin. It demonstrates core MCP concepts, including:

• Representing Anki decks and note models as resources using anki://decks/{id} and anki://models/{id} URIs.
• Tools for creating and managing Anki notes.
• Integration with the AnkiConnect API.

✨ Features

Resources

• List and access all decks using anki://decks/{id} URIs.
• List and access all note models using anki://models/{id} URIs.
• JSON representation of Anki objects.

Tools

• listDecks - Retrieve the names of all decks.
• listModels - Retrieve the names of all note models.
• getModel - Get detailed information about a specific note model.
• addNote - Create a single note.
  • Specify the deck name, model name, fields, and tags.
• addNotes - Create multiple notes in bulk.
  • Create multiple notes using specified parameters.

📦 Installation

Install Dependencies

npm install

Build the Server

npm run build

Development with Automatic Rebuild

npm run watch

🚀 Quick Start

When using with Claude Desktop, add the server configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "anki-mcp": {
      "command": "node",
      "args": ["d:\\anki-mcp-server\\build\\index.js"]
    }
  }
}

Debugging

Since MCP servers communicate via standard input and output, debugging can be challenging. We recommend using MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access the debugging tools in a browser.