Anki MCP Server

Name: Anki MCP Server
Author: ankimcp

CAUTIONgrade C · trust 79/100

A Model Context Protocol (MCP) server that enables AI assistants to interact with Anki, the spaced repetition flashcard application.

aiai learning toolai tutorankianki addonanki flashcards

Overview

From the repository's own README, as read at the audited commit.

# Anki MCP Server[![Tests](https://github.com/ankimcp/anki-mcp-server/actions/workflows/test.yml/badge.svg)](https://github.com/ankimcp/anki-mcp-server/actions/workflows/test.yml)[![npm version](https://badge.fury.io/js/@ankimcp%2Fanki-mcp-server.svg)](https://www.npmjs.com/package/@ankimcp/anki-mcp-server)<div align="center">  <img src="./docs/images/ankimcp.png" alt="Anki + MCP Integration" width="600" />  <p><strong>Seamlessly integrate <a href="https://apps.ankiweb.net">Anki</a> with AI assistants through the <a href="https://modelcontextprotocol.io">Model Context Protocol</a></strong></p></div>**Beta** - This project is in active development. APIs and features may change.A Model Context Protocol (MCP) server that enables AI assistants to interact with Anki, the spaced repetition flashcard application.Transform your Anki experience with natural language interaction - like having a private tutor. The AI assistant doesn't just present questions and answers; it can explain concepts, make the learning process more engaging and human-like, provide context, and adapt to your learning style. It can create and edit notes on the fly, turning your study sessions into dynamic conversations. More features coming soon!## Examples and TutorialsFor comprehensive guides, real-world examples, and step-by-step tutorials on using this MCP server with Claude Desktop, visit:**[ankimcp.ai](https://ankimcp.ai)** - Complete documentation with practical examples and use casesSee [`docs/`](./docs/README.md) for supplementary documentation, including the [reviewer setup guide](./docs/reviewer-setup.md) and the sample Anki deck.## Example Use CasesThree representative prompts showing the tool flows this server enables:1. **"Help me review my Spanish deck."** — The assistant syncs with AnkiWeb (`sync`), fetches due cards (`get_due_cards` with deck filter), presents each card (`present_card`), and records your rating (`rate_card`). Natural study conversation with explanations tailored to you

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code (npm)

claude mcp add anki-mcp-server -- npx -y @ankimcp/[email protected]

Exposed tools (48) 28 read · 14 write · 6 destructive

Blast radius: 6 tools can delete or overwrite. An agent that can be talked into calling a tool can be talked into calling this one.

Tool	Risk	Description
`addModelField`	write	Add a new field to an existing Anki note type (model).
`addTags`	write	Add tags to specified notes. Tags is a space-separated string (e.g.,
`anki_review`	read	Guidelines for conducting Anki spaced repetition review sessions
`changeDeck`	write	Move cards to a different deck. Target deck will be created if it doesn
`clearUnusedTags`	destructive	Remove orphaned tags that are not used by any notes in the collection. CRITICAL: This is destructive and permanent - only run when the user explicitly asks to clean up tags.
`collection_stats`	read	Get aggregated statistics across all decks in the collection including card counts, ease factor distribution, and interval distribution.
`createDeck`	write	Create a new empty Anki deck. Use
`createModel`	write	Create a new note type (model) in Anki with custom fields, card templates, and styling.
`deckStats`	read	Get comprehensive statistics for a single deck including card counts, ease and interval distributions. Pass a deck name (e.g.,
`deleteMediaFile`	destructive	Remove a media file from Anki
`deleteNotes`	destructive	Delete notes by their IDs. This will permanently remove the notes and ALL associated cards.
`findNotes`	read	Search for notes using Anki query syntax. Returns an array of note IDs matching the query.
`forgetCards`	destructive	Reset cards to the new queue, discarding their current scheduling (interval, due date, and ease factor).
`getMediaFilesNames`	read	List media files in Anki
`getTags`	read	Get all tags in the Anki collection. Use this to discover existing tags before creating notes to maintain consistency and prevent tag duplication (e.g., avoiding
`guiAddCards`	write	Open Anki Add Cards dialog with preset note details (deck, model, fields, tags). Returns potential note ID.
`guiBrowse`	read	Open Anki Card Browser and search for cards using Anki query syntax. Returns array of card IDs found.
`guiCurrentCard`	read	Get information about the current card displayed in review mode. Returns card details (question, answer, deck, model, etc.) or null if not in review.
`guiDeckBrowser`	read	Open Anki Deck Browser dialog showing all decks.
`guiDeckOverview`	read	Open Anki Deck Overview dialog for a specific deck. Shows deck statistics and study options. Returns true if succeeded.
`guiEditNote`	read	Open Anki note editor dialog for a specific note ID. Allows manual editing of note fields, tags, and cards in the GUI.
`guiSelectCard`	read	Select a specific card in an open Card Browser window. Returns true if browser is open and card was selected, false if browser is not open.
`guiSelectedNotes`	read	Get the IDs of notes currently selected in the Card Browser. Returns array of note IDs (empty if no selection).
`guiShowAnswer`	read	Show the answer side of the current card in review mode. Returns true if in review mode, false otherwise.
`guiShowQuestion`	read	Show the question side of the current card in review mode. Returns true if in review mode, false otherwise.
`guiUndo`	read	Undo the last action or card in Anki. Returns true if undo succeeded, false otherwise.
`listDecks`	read	List all Anki decks, optionally with per-deck study-queue statistics.
`modelFieldNames`	read	Get the field names for a specific note type (model). Use this to know what fields are required when creating notes of this type.
`modelNames`	read	Get a list of all available note type (model) names in Anki. Use this to see what note types are available before creating notes.
`modelStyling`	read	Get the CSS styling for a specific note type (model). This CSS is used when rendering cards of this type.
`modelTemplates`	read	Get the card templates (Front and Back HTML) for a specific note type (model).
`notesInfo`	read	Get detailed information about specific notes including all fields, tags, model info, and CSS styling.
`present_card`	read	Retrieve a card\
`rate_card`	write	Submit a rating for a card to update Anki
`removeModelField`	destructive	Remove a field from an existing Anki note type (model).
`removeTags`	destructive	Remove tags from specified notes. Tags is a space-separated string (e.g.,
`renameModelField`	write	Rename a field in an existing Anki note type (model).
`replaceTags`	write	Rename a tag across specified notes (e.g.,
`repositionModelField`	read	Change the position of a field within an Anki note type (model).
`retrieveMediaFile`	read	Download a media file from Anki
`review_stats`	read	Get review history analysis including temporal patterns, retention metrics, and study streak information.
`setDueDate`	read	Reschedule cards to become due in a given number of days, without recording a review.
`storeMediaFile`	write	Upload a media file to Anki
`sync`	write	Synchronize local Anki collection with AnkiWeb. IMPORTANT: Always sync at the START of a review session (before getting cards) and at the END when user indicates they are done. This ensures data consistency across devices.
`system-info`	read	Current system information and environment
`updateModelStyling`	write	Update the CSS styling for an existing note type (model).
`updateModelTemplates`	write	Update the card templates (Front and Back HTML) for an existing note type (model).
`updateNoteFields`	write	Update the fields of an existing note. Supports HTML content in fields and preserves CSS styling.

Details

Source: ankimcp/anki-mcp-server
npm: @ankimcp/anki-mcp-server@0.25.1
Transports: stdio · streamable-http
Credentials it reads: ANKI_CONNECT_API_KEYTUNNEL_AUTH_CLIENT_ID
License: MIT
Stars: 476 · pushed 3d ago

Trust audit

Install with care. The audit found things worth knowing before you trust its output.

Layer	What it checks	Result
L0	Provenance & inventory	PASS
L1	Static analysis of the code	WARN
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	WARN
L4	Behavioural (sandbox)	SKIPPED

What the source does

Filesystem: declared (2 observation(s))
Network: declared (2 observation(s))
Shell: none-observed
Dependencies: not all pinned
Secrets in source: none-found

Findings (25)

MEDIUMNetwork egress · net.raw_ip · CWE-200, CWE-319

scripts/e2e-full.sh:68

if ! curl -s http://127.0.0.1:3000 > /dev/null 2>&1; then

MEDIUMFilesystem / path · mcp.destructive_tools · CWE-22, CWE-59

clearUnusedTags, deleteMediaFile, deleteNotes, forgetCards, removeModelField, removeTags

Why it matters. 6 tool(s) can delete or overwrite

Fix. prefer a read-only mode or scoped tokens; the page states the blast radius

LOWInventory / provenance · inv.binary · CWE-1104

docs/MCP Reviewer Demo.apkg

MCP Reviewer Demo.apkg

Why it matters. a compiled or binary member cannot be reviewed from source

Fix. ship source, or explain the binary in the README

LOWInventory / provenance · inv.hidden_file · CWE-1104

.mcpbignore

.mcpbignore

Why it matters. hidden member outside the usual dotfiles

Fix. review its purpose

LOWFilesystem / path · fs.credential_store · CWE-22, CWE-59

src/mcp/primitives/essential/tools/__tests__/store-media-file.tool.spec.ts:161

it("should reject non-media file paths (e.g., .ssh/id_rsa)", async () => {