# anki-mcp-server-addon

> An Anki addon that implements an MCP server, enabling AI assistants to interact with Anki, the spaced repetition flashcard application.

- **URL**: https://www.freshcrate.ai/projects/anki-mcp-server-addon
- **Author**: ankimcp
- **Category**: MCP Servers
- **Latest version**: `v0.18.0` (2026-06-05)
- **License**: NOASSERTION
- **Source**: https://github.com/ankimcp/anki-mcp-server-addon
- **Homepage**: https://ankimcp.ai
- **Language**: Python
- **GitHub**: 34 stars, 3 forks
- **Registry**: github
- **Tags**: `ai`, `anki-addon`, `anki-mcp`, `mcp`, `python`

## Description

An Anki addon that implements an MCP server, enabling AI assistants to interact with Anki, the spaced repetition flashcard application.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.18.0` | 2026-06-05 | High | ## What's New  ### ● Toolbar status indicator A persistent **`● AnkiMCP`** item now sits in Anki's top toolbar and shows the tunnel connection state at a glance: - **grey** — tunnel off / disconnected - **amber** — connecting or reconnecting - **green** — connected  Click it to open *AnkiMCP Server Settings*. Shown by default; hide it with the new `show_toolbar_indicator` config option (set `false`, then restart Anki).  ### Cleaner tunnel disconnect Disconnecting the tunnel now reliably logs **" |
| `v0.16.0` | 2026-05-27 | High | **Minor release: server now runs in stateless HTTP mode, aligning with the upcoming MCP 2026-07-28 protocol direction.**  ## ✨ Features  - **Stateless HTTP transport** ([#43](https://github.com/ankimcp/anki-mcp-server-addon/pull/43), closes [#42](https://github.com/ankimcp/anki-mcp-server-addon/issues/42)) — The MCP server no longer emits or requires the `mcp-session-id` header on Streamable HTTP requests. Passes `stateless_http=True` to FastMCP, so each HTTP request gets a fresh transport. This |
| `v0.15.1` | 2026-05-13 | High | **Patch release with two fixes since v0.15.0.**  ## 🐛 Fixes  - **Distro-packaged Anki compatibility** ([#41](https://github.com/ankimcp/anki-mcp-server-addon/pull/41), fixes [#40](https://github.com/ankimcp/anki-mcp-server-addon/issues/40)) — On Arch, Fedora, and other distros where Anki uses system Python with a system-installed `pydantic-core`, the addon previously crashed at startup if that version differed from what our vendored `pydantic` required (`SystemError: incompatible pydantic-core |
| `v0.15.0` | 2026-04-23 | High | ## What's new  - **Server identity**: addon now exposes its icon and website URL via the MCP protocol (`serverInfo.icons` + `websiteUrl` in the `initialize` response). Spec-aware MCP clients render the branding; claude.ai's connector UI ignores these fields today (tracked upstream as anthropics/claude-ai-mcp#152). - **MCP registry**: ships with `server.json` for publication to the official registry under `ai.ankimcp/anki-mcp-server-addon`.  ## Internals  - Tightened `mcp` dependency constraint t |
| `v0.14.0` | 2026-04-09 | High | ## Security Fix: Media Path Traversal & SSRF Prevention  Thanks to **[Hideaki Takahashi](https://github.com/Koukyosyumei)** (Columbia University) for responsibly disclosing the media path traversal vulnerability.  ### What was fixed  - **Path traversal in `store_media_file`** — the `path` parameter accepted arbitrary file paths without validation, allowing reading any file on the system (SSH keys, `.env`, credentials). Now restricted to media MIME types only (image/audio/video) - **SSRF via `sto |
| `v0.13.0` | 2026-04-09 | Medium | ## NixOS & Source Install Support  This release adds first-class NixOS support and graceful handling for source-based installs.  ### What's New  - **NixOS support** — Ships a `flake.nix` for one-line NixOS installs. Symlinks nixpkgs Python packages into `vendor/shared/` so the addon works natively with `anki.withAddons`. - **Source install fallback** — When `vendor/` is missing (Nix, pip from source, Guix), the addon detects system-provided packages and uses them instead of crashing. Clear error |
| `v0.12.0` | 2026-04-04 | Medium | ## What's Changed  ### New: `get_info` action for `filtered_deck` ([#35](https://github.com/ankimcp/anki-mcp-server-addon/pull/35))  Inspect filtered deck configuration without modifying anything. Retrieves search terms, sort order, card count, and reschedule settings for up to 50 decks at once.  ```json {"action": "get_info", "deck_ids": [1234567890]} ```  Returns per-deck details including: - `search_terms` — each term's search query, card limit, and sort order (human-readable, e.g. "random" i |
| `v0.11.0` | 2026-03-28 | Medium | ## What's Changed  ### New: Dry-run deletions ([#33](https://github.com/ankimcp/anki-mcp-server-addon/pull/33))  `delete_notes` now supports `dry_run=true` to preview what would be deleted without actually deleting anything. Returns the same response shape (deletedCount, cardsDeleted, notFoundCount) so you can inspect before committing.  ```json {"notes": [1234, 5678], "confirmDeletion": true, "dry_run": true} ```  The `confirmDeletion` safeguard is ignored during dry runs — no confirmation need |
| `v0.10.0` | 2026-03-26 | Medium | ## What's Changed  ### Fix: Multi-session response routing ([#21](https://github.com/ankimcp/anki-mcp-server-addon/issues/21))  Multiple concurrent MCP sessions (e.g., Claude Code + Claude Desktop, or multi-agent workflows) now work correctly. Previously, the shared response queue could misroute responses between sessions.  The fix replaces the shared `response_queue` with per-request response routing — each request gets its own private queue keyed by `request_id`. Community-tested with **29 con |
| `v0.9.0` | 2026-03-14 | Low | ## What's Changed  ### New: `add_notes` batch tool ([#24](https://github.com/ankimcp/anki-mcp-server-addon/issues/24))  Add up to 100 notes in a single call, sharing the same deck and model. Uses Anki's native batch API for a single backend call with atomic undo.  ```json {   "deck_name": "Spanish",   "model_name": "Basic",   "tags": ["vocab"],   "notes": [     {"fields": {"Front": "hola", "Back": "hello"}},     {"fields": {"Front": "adiós", "Back": "goodbye"}, "tags": ["farewell"]},     {"field |

## Dependency audit

- **Score**: 77/100
- **Total deps**: 4
- **Resolved**: 1
- **Unresolved**: 3
- **License conflicts**: 0
- **Warnings**: 4
- **Scanned**: 2026-05-18

## Citation

- HTML: https://www.freshcrate.ai/projects/anki-mcp-server-addon
- Markdown: https://www.freshcrate.ai/projects/anki-mcp-server-addon.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/anki-mcp-server-addon/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._