Anki

by camdenclark

37 stars
Not rated
GitHub

About

Integrates with Anki flashcard decks via AnkiConnect to enable automated creation, retrieval, and management of study materials.

Details

Author
camdenclark
Repository
CamdenClark/anki-mcp-server
GitHub stars
37
License
MIT License
Categories
Productivity, Design, Developer Tools, AI, Automation, Infrastructure, Knowledge Base

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Anki
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 d:\anki-mcp-server\build\index.js

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

To use with Claude Desktop, add the server config:

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"]
    }
  }
}

listDecks

Get names of all decks.

listModels

Get names of all note models.

getModel

Get details of a specific note model.

addNote

Create a single note. Parameters: deck name, model name, fields, and tags.

addNotes

Create multiple notes in bulk with specified parameters.

- listDecks - Get names of all decks
- listModels - Get names of all note models
- getModel - Get details of a specific note model
- addNote - Create a single note
- Specify deck name, model name, fields and tags
- addNotes - Create multiple notes in bulk
- Create many notes with specified parameters

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "anki": {
            "cwd": "~/Library/Application Support/Claude",
            "env": {},
            "args": [
                "d:\\anki-mcp-server\\build\\index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Linux

{
    "cwd": null,
    "env": [],
    "args": [
        "d:\\anki-mcp-server\\build\\index.js"
    ],
    "shell": false,
    "command": "node"
}

Macos

{
    "cwd": "~/Library/Application Support/Claude",
    "env": [],
    "args": [
        "d:\\anki-mcp-server\\build\\index.js"
    ],
    "shell": false,
    "command": "node"
}

Windows

{
    "cwd": "%APPDATA%/Claude",
    "env": [],
    "args": [
        "d:\\anki-mcp-server\\build\\index.js"
    ],
    "shell": false,
    "command": "node"
}

anki-mcp MCP Server

A server to integrate with Anki via the AnkiConnect plugin

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

- Resources representing Anki decks and note models with URIs
- Tools for creating and managing Anki notes
- Integration with AnkiConnect API

Features

Resources

- List and access Anki decks via anki://decks/{id} URIs - List and access note models via anki://models/{id} URIs - JSON representation of Anki objects

Tools

- listDecks - Get names of all decks - listModels - Get names of all note models - getModel - Get details of a specific note model - addNote - Create a single note - Specify deck name, model name, fields and tags - addNotes - Create multiple notes in bulk - Create many notes with specified parameters

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

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 over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.