Related Pages

Related topics: Entrypoints and Runtime Surface, Architecture Evidence Map, Operations and Verification Boundaries

Repository Overview

This page is generated from repository evidence because the Human Wiki provider was unavailable. It intentionally limits itself to README and file-tree facts.

README Evidence

Anki MCP Server

⚠️ IMPORTANT: Project Renamed (v0.8.2+)

This project has been renamed and moved:

- Package: anki-mcp-http → @ankimcp/anki-mcp-server

- Commands: anki-mcp-http → ankimcp or anki-mcp-server

- Repository: anki-mcp/anki-mcp-desktop → ankimcp/anki-mcp-server

The old anki-mcp-http package continues to be published for backward compatibility but is deprecated. Please migrate to the new package.

Read more about this change →

 

<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 Tutorials

For comprehensive guides, real-world examples, and step-by-step tutorials on using this MCP server with Claude Desktop, visit:

ankimcp.ai - Complete documentation with practical examples and use cases

See docs/ for supplementary documentation, including the reviewer setup guide and the sample Anki deck.

Example Use Cases

Three 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_

[excerpt truncated]

Selected Source Inventory

• README.md
• package.json
• .docker/docker-compose.yml
• docs/README.md
• src/anki-config.service.ts
• src/app.module.spec.ts
• src/app.module.ts
• src/bootstrap.ts
• src/cli.ts
• src/main-http.ts
• src/main-stdio.ts
• src/mcp/mcp-icons.ts

Source: README.md:1-120

Related Pages

Related topics: Repository Overview, Architecture Evidence Map, Operations and Verification Boundaries

Entrypoints and Runtime Surface

The files below are the highest-signal candidates for how the project is installed, started, configured, or embedded. Treat this as an evidence map, not an inferred API contract.

Source: README.md:1-120

Related Pages

Related topics: Repository Overview, Entrypoints and Runtime Surface, Operations and Verification Boundaries

Architecture Evidence Map

This section maps source paths into likely architectural areas based on repository layout only. Claims that require execution are intentionally not made here.

• .: README.md, package.json
• .docker: .docker/docker-compose.yml
• docs: docs/README.md
• src: src/anki-config.service.ts, src/app.module.spec.ts, src/app.module.ts, src/bootstrap.ts, src/cli.ts, src/main-http.ts

Source: package.json:1-120

Related Pages

Related topics: Repository Overview, Entrypoints and Runtime Surface, Architecture Evidence Map

Operations and Verification Boundaries

Operational guidance is limited to files that are present in the repository. Before using this project in an agent workflow, verify install, quickstart, and runtime behavior in a sandbox.

• Documentation signal: README.md
• Runtime/package signal: package.json
• Containerization signal: .docker/docker-compose.yml
• Documentation signal: docs/README.md
• Source inspection signal: src/anki-config.service.ts
• Source inspection signal: src/app.module.spec.ts
• Source inspection signal: src/app.module.ts
• Source inspection signal: src/bootstrap.ts
• Source inspection signal: src/cli.ts
• Source inspection signal: src/main-http.ts

Source: .docker/docker-compose.yml:1-120

Doramagic Pitfall Log

Doramagic extracted 14 source-linked risk signals. Review them before installing or handing real data to the project.

1. Installation risk: Anki mcp for mcp clients fails with 'ERR_REQUIRE_ESM'

• Severity: medium
• Finding: Installation risk is backed by a source signal: Anki mcp for mcp clients fails with 'ERR_REQUIRE_ESM'. Treat it as a review item until the current version is checked.
• User impact: First-time setup may fail or require extra isolation and rollback planning.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/ankimcp/anki-mcp-server/issues/12

2. Installation risk: Crash on startup: ERR_REQUIRE_ESM when requiring 'ky'

• Severity: medium
• Finding: Installation risk is backed by a source signal: Crash on startup: ERR_REQUIRE_ESM when requiring 'ky'. Treat it as a review item until the current version is checked.
• User impact: First-time setup may fail or require extra isolation and rollback planning.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/ankimcp/anki-mcp-server/issues/16

3. Installation risk: Feature Request: Deck and Collection Level Statistics

• Severity: medium
• Finding: Installation risk is backed by a source signal: Feature Request: Deck and Collection Level Statistics. Treat it as a review item until the current version is checked.
• User impact: First-time setup may fail or require extra isolation and rollback planning.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/ankimcp/anki-mcp-server/issues/14

4. Installation risk: Not possible to install Anki MCP 0.8.4 to latest Claude Desktop Claude 1.0.1307 (1ed883)

• Severity: medium
• Finding: Installation risk is backed by a source signal: Not possible to install Anki MCP 0.8.4 to latest Claude Desktop Claude 1.0.1307 (1ed883). Treat it as a review item until the current version is checked.
• User impact: First-time setup may fail or require extra isolation and rollback planning.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/ankimcp/anki-mcp-server/issues/10

5. Installation risk: ngrok fails to start with latest version

• Severity: medium
• Finding: Installation risk is backed by a source signal: ngrok fails to start with latest version. Treat it as a review item until the current version is checked.
• User impact: First-time setup may fail or require extra isolation and rollback planning.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/ankimcp/anki-mcp-server/issues/9

6. Configuration risk: Explicitly exclude Node 21.x in engines field

• Severity: medium
• Finding: Configuration risk is backed by a source signal: Explicitly exclude Node 21.x in engines field. Treat it as a review item until the current version is checked.
• User impact: Users may get misleading failures or incomplete behavior unless configuration is checked carefully.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/ankimcp/anki-mcp-server/issues/17

7. Capability assumption: README/documentation is current enough for a first validation pass.

• Severity: medium
• Finding: README/documentation is current enough for a first validation pass.
• User impact: The project should not be treated as fully validated until this signal is reviewed.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: capability.assumptions | mcp_registry:ai.ankimcp/anki-mcp-server:0.18.5 | https://registry.modelcontextprotocol.io/v0.1/servers/ai.ankimcp%2Fanki-mcp-server/versions/0.18.5 | README/documentation is current enough for a first validation pass.

8. Project risk: getting lots of timeouts creating cards

• Severity: medium
• Finding: Project risk is backed by a source signal: getting lots of timeouts creating cards. Treat it as a review item until the current version is checked.
• User impact: The project should not be treated as fully validated until this signal is reviewed.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/ankimcp/anki-mcp-server/issues/22

9. Maintenance risk: Maintainer activity is unknown

• Severity: medium
• Finding: Maintenance risk is backed by a source signal: Maintainer activity is unknown. Treat it as a review item until the current version is checked.
• User impact: Users cannot judge support quality until recent activity, releases, and issue response are checked.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: evidence.maintainer_signals | mcp_registry:ai.ankimcp/anki-mcp-server:0.18.5 | https://registry.modelcontextprotocol.io/v0.1/servers/ai.ankimcp%2Fanki-mcp-server/versions/0.18.5 | last_activity_observed missing

10. Security or permission risk: no_demo

• Severity: medium
• Finding: no_demo
• User impact: The project may affect permissions, credentials, data exposure, or host boundaries.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: downstream_validation.risk_items | mcp_registry:ai.ankimcp/anki-mcp-server:0.18.5 | https://registry.modelcontextprotocol.io/v0.1/servers/ai.ankimcp%2Fanki-mcp-server/versions/0.18.5 | no_demo; severity=medium

11. Security or permission risk: no_demo

• Severity: medium
• Finding: no_demo
• User impact: The project may affect permissions, credentials, data exposure, or host boundaries.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: risks.scoring_risks | mcp_registry:ai.ankimcp/anki-mcp-server:0.18.5 | https://registry.modelcontextprotocol.io/v0.1/servers/ai.ankimcp%2Fanki-mcp-server/versions/0.18.5 | no_demo; severity=medium

12. Security or permission risk: Feature: Configurable tool permissions (read-only mode)

• Severity: medium
• Finding: Security or permission risk is backed by a source signal: Feature: Configurable tool permissions (read-only mode). Treat it as a review item until the current version is checked.
• User impact: The project may affect permissions, credentials, data exposure, or host boundaries.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/ankimcp/anki-mcp-server/issues/18

Community Discussion Evidence

Doramagic exposes project-level community discussion separately from official documentation. Review these links before using anki-mcp-server with real data or production workflows.

• getting lots of timeouts creating cards - github / github_issue
• Feature: Configurable tool permissions (read-only mode) - github / github_issue
• Explicitly exclude Node 21.x in engines field - github / github_issue
• Crash on startup: ERR_REQUIRE_ESM when requiring 'ky' - github / github_issue
• Feature Request: Deck and Collection Level Statistics - github / github_issue
• Anki mcp for mcp clients fails with 'ERR_REQUIRE_ESM' - github / github_issue
• Add listTags tool to retrieve all available tags in Anki collection - github / github_issue
• Not possible to install Anki MCP 0.8.4 to latest Claude Desktop Claude 1 - github / github_issue
• ngrok fails to start with latest version - github / github_issue
• v0.15.1: Media security hardening - github / github_release
• README/documentation is current enough for a first validation pass. - GitHub / issue