Skip to main content

Anki Addons MCP

An MCP server that gives LLM clients read-only access to the Anki Addons dataset: every addon in the AnkiWeb catalog, enriched with GitHub, Anki Forum and AI-summary and AI-tag data, published as monthly snapshots.

It answers questions such as "which addon does X?", "will it work on Anki 25.02?", "is it maintained?", and "what changed since last month?".

Use it locally (STDIO)

Requires uv. uvx runs the PyPI package in an isolated, cached environment; to run a working copy instead, see Run from sources.

Register the server in Claude Code:

claude mcp add anki-addons -- uvx anki-addons-mcp

Other MCP clients use the same command (uvx anki-addons-mcp) in their server configuration, e.g.:

{
  "mcpServers": {
    "anki-addons": { "command": "uvx", "args": ["anki-addons-mcp"] }
  }
}

The first start downloads the latest snapshot (~20 MB) into the HuggingFace cache. Older snapshots are downloaded on demand by history tools, so the first history question can take a minute.

Use it remotely (Streamable HTTP)

Connect to the hosted instance on the HuggingFace Space by URL:

claude mcp add --transport http anki-addons https://ya-alex-anki-addons-mcp.hf.space/mcp

The Space sleeps after inactivity, so the first request can take a while. To explore the server in a browser, see Debug with the MCP Inspector.

To host your own instance, see Run over HTTP and Deploy to a HuggingFace Space.

Capabilities

Tools (all read-only, every data tool takes an optional snapshot, YYYY-MM-DD or latest): search_addons, filter_addons, get_addon, get_addon_readme, get_addon_description, check_compatibility, assess_maintenance, compare_forks, find_similar_addons, list_addons_by_author, get_addon_reviews, get_addon_packages, get_addon_history, diff_snapshots, get_statistics, top_addons, list_snapshots, list_tags, list_anki_versions, and query_sql (one sandboxed DuckDB SELECT over the addons, tags, anki_versions, reviews and packages tables; only offered by SQL-capable backends). search_addons accepts every filter of filter_addons (including AI tags with tags and exclude_tags) and combines them with the text query. Compatibility follows Anki's parsed versions (point versions and the hard/tested/open/unknown kind of the upper version); both tools filter by anki_version_kind and anki_version_at_least, and filter_addons also sorts by anki_version. list_anki_versions lists the stable Anki releases of a snapshot, newest first, with their release dates (empty for snapshots collected before the dataset published them). list_addons_by_author takes a GitHub user, or an AnkiWeb author by author_id or by any of the author's addons (addon_id). AnkiWeb authors are derived by the dataset and are missing in snapshots collected before authors were tracked. get_addon_description returns plain text, or the author's unsanitized HTML with format=html. get_addon_reviews lists an addon's AnkiWeb user reviews newest first (anonymous, with the author's reply when there is one) and filters them by vote, contains text and since date, e.g. to find reports of breakage on a new Anki. get_addon shows how the Anki Forum topic was found in forum.topic_source (override, contact_author, ai or most_linked). get_addon also shows GitHub activity from 2026-11-01 on: commits per week, contributors, separate issue and pull request counts, maintainer response time and releases (the release list with include=releases). assess_maintenance reports these as signals and reasons, while its label still rests on dates and the archived flag alone. get_addon_packages lists the .ankiaddon packages of an addon, one per branch (sizes, file and Python line counts, download URL; raw manifest.json, config.json and the file list with include). It is empty for snapshots before 2026-11-01, and the packages stay under their authors' licenses, not the dataset's CC0. Fork relations come from the dataset: get_addon shows forked_from, the one addon it was forked from or null (with its evidence: github_fork, ai or override), forks (any number) and github.fork_source; cards carry the ids. search_addons and filter_addons filter by is_fork, has_forks and fork_of (the forks of one addon, e.g. a maintained fork of an abandoned addon); find_similar_addons and assess_maintenance point to them. compare_forks returns the whole fork family of an addon (the original, its forks and forks of forks; the same family from any member) with each version's place in the family, compatibility with the latest or a given Anki version, maintenance label, votes, stars and status flags, without picking a winner. Detection is incomplete and ai evidence may be wrong.

Resources: anki-addons://dataset/readme, anki-addons://dataset/schema, anki-addons://dataset/anki-versions, anki-addons://snapshots, anki-addons://snapshots/{snapshot}/metadata, anki-addons://snapshots/{snapshot}/aggregation, anki-addons://addons/{addon_id} (and /readme, /description, /description.html, /reviews, /packages, /history), anki-addons://authors/{github_user}, anki-addons://tags, anki-addons://tags/{tag}, anki-addons://anki-versions.

Prompts: find_addon_for_task, compare_addons, addon_health_report, upgrade_readiness, monthly_ecosystem_digest, before_you_build, author_portfolio, best_in_category, category_landscape, anki_release_readiness.

AI summaries and tags in the dataset are LLM-generated; the server labels them as such.

Configuration

CLI flags override environment variables (prefix ANKI_MCP_, also read from .env).

Variable Default Meaning
ANKI_MCP_TRANSPORT stdio stdio or http
ANKI_MCP_HOST / ANKI_MCP_PORT / ANKI_MCP_PATH 127.0.0.1 / 8000 / /mcp HTTP binding
ANKI_MCP_ALLOWED_HOSTS [] JSON list of Host headers to allow (enables DNS-rebinding protection)
ANKI_MCP_BACKEND hf_parquet hf_parquet (HuggingFace Hub) or local_parquet (a local copy)
ANKI_MCP_HF_REPO_ID / ANKI_MCP_HF_REVISION Ya-Alex/anki-addons / main Dataset to serve
ANKI_MCP_DATA_DIR Dataset directory for local_parquet (latest/, history/<date>/)
ANKI_MCP_CACHE_DIR HF cache Download cache
ANKI_MCP_REFRESH_INTERVAL_SECONDS 3600 Check for a new dataset revision; 0 disables
ANKI_MCP_SQL_ENABLED / _SQL_MAX_ROWS / _SQL_TIMEOUT_SECONDS true / 200 / 10 query_sql limits
ANKI_MCP_MAINTENANCE_ACTIVE_DAYS / _STALE_DAYS 180 / 730 Maintenance label thresholds
ANKI_MCP_LOG_LEVEL INFO Logs go to stderr
HF_TOKEN Optional HuggingFace token for higher download rate limits (a Space secret)

Metadata

Release files for anki-addons-mcp 0.9.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for anki-addons-mcp 0.9.1
File Size Uploaded Provenance Actions
anki_addons_mcp-0.9.1.tar.gz 79.6 kB With provenance Details for anki_addons_mcp-0.9.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for anki-addons-mcp 0.9.1
File Interpreter ABI Platform Actions
anki_addons_mcp-0.9.1-py3-none-any.whl Python 3 none any Details for anki_addons_mcp-0.9.1-py3-none-any.whl

Total release size: 149.6 kB

Release files / anki_addons_mcp-0.9.1.tar.gz

Download URL anki_addons_mcp-0.9.1.tar.gz
Size 79.6 kB
Tags Source
SHA-256 checksum
How to use checksums
134029764ac3e33a3b9d7f577d0abab5d8f7190c89da6abccdb125294282fb4b
BLAKE2b-256 checksum
How to use checksums
b26bc5c3b7bf843917cc3d230fb1b50b55c161e2cb9d3f35ac2195a88fb1fbff
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.

Transparency log

Release files / anki_addons_mcp-0.9.1-py3-none-any.whl

Download URL anki_addons_mcp-0.9.1-py3-none-any.whl
Size 70.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e5583c094e8b577a4f7a35c27c80c569e382cde3b1c90400ca45e91bfbf09d35
BLAKE2b-256 checksum
How to use checksums
70c8cf2d739a6a6b4860fd0e950097facd1a51ce39668ff12a03d1ceb3c0444e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.

Transparency log

Security for anki-addons-mcp 0.9.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for anki_addons_mcp-0.9.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page