Skip to main content
Glama

Anki MCP Server

by ethangillani

Anki MCP Server

A Model Context Protocol (MCP) server that enables LLMs to interact with Anki flashcard software through the AnkiConnect API.

Features

  • Create new decks in Anki
  • Add notes to existing decks
  • List available decks and note models
  • Search for notes using Anki's search syntax
  • Get detailed information about note models and their fields
  • Bulk add multiple notes at once

Prerequisites

  • Node.js (v14 or later)
  • Anki with the AnkiConnect add-on installed
  • A Model Context Protocol compatible client (such as Claude with Anthropic MCP support)

Installation

  1. Make sure you have Anki installed with the AnkiConnect add-on
    • Install AnkiConnect by going to Tools > Add-ons > Get Add-ons and entering code: 2055492159
  2. Clone this repository:
    git clone https://github.com/yourusername/anki-mcp-server.git cd anki-mcp-server
  3. Install dependencies:
    npm install
  4. Build the project:
    npm run build

Usage

  1. Make sure Anki is running on your computer with AnkiConnect enabled
  2. Start the MCP server:
    npm start
  3. Connect your MCP client (e.g., Claude) to this server

Available Tools

The server provides the following tools to MCP clients:

  • listDecks: Get a list of all decks in Anki
  • listModels: Get a list of all note models/types in Anki
  • createDeck: Create a new deck in Anki
  • getModel: Get details about a specific note model/type
  • addNote: Add a single note to a deck
  • addNotes: Add multiple notes at once
  • searchNotes: Search for notes using Anki's search syntax

Examples

Create a New Deck

{ "name": "createDeck", "arguments": { "name": "My New Deck" } }

Add a Note

{ "name": "addNote", "arguments": { "deckName": "My New Deck", "modelName": "Basic", "fields": { "Front": "What is the capital of France?", "Back": "Paris" }, "tags": ["geography", "europe"] } }

Search Notes

{ "name": "searchNotes", "arguments": { "query": "deck:\"My New Deck\" tag:geography" } }

Configuration

The server configuration is in the config object in src/index.ts. You can modify:

  • ankiConnectUrl: URL for the AnkiConnect API (default: http://localhost:8765)
  • apiVersion: API version for AnkiConnect (default: 6)
  • defaultDeckName: Default deck to use if none specified (default: Default)

Troubleshooting

  1. Cannot connect to Anki
    • Make sure Anki is running
    • Check that AnkiConnect add-on is installed and working
    • Verify that the AnkiConnect URL is correct (default: http://localhost:8765)
  2. Permission issues with AnkiConnect
    • AnkiConnect may prompt for permission when the server tries to add cards. Look for a popup in Anki.

License

MIT License

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that allows LLMs to interact with Anki flashcard software, enabling functions like creating decks, adding notes, searching cards, and managing flashcard content through natural language.

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Available Tools
            1. Examples
              1. Create a New Deck
              2. Add a Note
              3. Search Notes
            2. Configuration
              1. Troubleshooting
                1. License

                  Related MCP Servers

                  • A
                    security
                    A
                    license
                    A
                    quality
                    A server implementation that connects to a locally running Anki, enabling card review and creation through the Model Context Protocol.
                    Last updated -
                    4
                    148
                    JavaScript
                    MIT License
                    • Apple
                  • A
                    security
                    F
                    license
                    A
                    quality
                    A Model Context Protocol server that enables LLMs to interact with Anki flashcard software through AnkiConnect, allowing for creation and management of flashcards, decks, and note types.
                    Last updated -
                    10
                    34
                    84
                    TypeScript
                    • Apple
                  • -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that bridges Claude AI with Anki flashcard app, allowing users to create and manage flashcards using natural language commands.
                    Last updated -
                    3
                    Python
                    MIT License
                    • Apple
                    • Linux
                  • -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that enables language models to interact with Anki flashcard decks programmatically, with specialized features for Japanese language learning including vocabulary import, sample sentence generation, and spaced repetition review.
                    Last updated -
                    2
                    Python
                    MIT License

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/ethangillani/Anki-MCP-Server'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server