- Home
- MCP servers
- Anki
Anki
- typescript
229
GitHub Stars
typescript
Language
6 months ago
First Indexed
2 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
Installation
Add the following to your MCP client configuration file.
Configuration
View docs{
"mcpServers": {
"nailuogg-anki-mcp-server": {
"command": "npx",
"args": [
"--yes",
"anki-mcp-server"
],
"env": {
"EXAMPLE_ENV": "YOUR_VALUE"
}
}
}
}You can run an MCP server that lets LLMs talk to Anki through AnkiConnect. This makes it practical to manage decks, notes, and note types from an autonomous agent or your own tools, without switching apps manually.
How to use
You connect your MCP client to the Anki MCP Server to perform deck and note operations. Common workflows include listing decks, creating decks, adding notes (Basic or Cloze), querying notes, updating notes, and deleting notes. You can also inspect available note types and their structures. If you run an AnkiConnect instance on a different port, you can adjust the port when starting the server.
To use it with your MCP client, add the Anki MCP Server as a configured endpoint. The server runs as a local process started by a command such as npx --yes anki-mcp-server (optionally followed by --port to specify a non-default AnkiConnect port). Once started, your client can invoke the supported tools to manage decks, notes, and note types within Anki.
How to install
Prerequisites you need before installing: Anki installed on your system and the AnkiConnect add-on installed in Anki.
Install via Desktop Extension (.mcpb). The easiest way to use this server is to package it as a Desktop Extension and install it in Claude Desktop.
Steps to install locally and prepare for use:
-
Build the distributable bundle locally.
-
Import the generated
.mcpbbundle into Claude Desktop via Settings → Extensions → Install.
Additional sections
Configuration and startup details are shown below, including how to run the server with a custom AnkiConnect port if needed.
Usage with Claude Desktop and Cline: you add the server to your client’s MCP settings to enable communication with Anki. You can keep using the default port or specify a custom port if AnkiConnect is listening elsewhere.
Development and testing notes: the server is designed to work over stdio, and you can inspect MCP messages and server activity with an inspector tool during development.
Example usage scenarios include creating a new deck, adding a basic card, or adding a cloze deletion card to verify end-to-end functionality.
Tools and endpoints
The server exposes a set of tools to interact with Anki via MCP. You can list decks, create decks, create notes, perform batch note creation, search notes, retrieve note info, update notes, delete notes, list note types, create note types, and get detailed note type schemas.
Available tools
list_decks
List all available Anki decks to discover what you can work with.
create_deck
Create a new Anki deck by name to organize your notes.
create_note
Create a new note (Basic or Cloze) in a specified deck.
batch_create_notes
Create multiple notes in one operation to accelerate card population.
search_notes
Search notes using Anki query syntax to locate existing cards.
get_note_info
Retrieve detailed information about a specific note.
update_note
Update fields of an existing note.
delete_note
Remove a note from a deck.
list_note_types
List all available note types in the Anki collection.
create_note_type
Create a new note type (model) for future notes.
get_note_type_info
Get detailed structure information for a specific note type.