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 (~15 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_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 and anki_versions 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 (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. 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, /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.8.0

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.8.0
File Size Uploaded Provenance Actions
anki_addons_mcp-0.8.0.tar.gz 65.0 kB With provenance Details for anki_addons_mcp-0.8.0.tar.gz

Built distribution (wheel)

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

Total release size: 126.3 kB

Release files / anki_addons_mcp-0.8.0.tar.gz

Download URL anki_addons_mcp-0.8.0.tar.gz
Size 65.0 kB
Tags Source
SHA-256 checksum
How to use checksums
a91bb4a41f6570e125517023896877d4e6d2c7436194c10a1b988352ee020df4
BLAKE2b-256 checksum
How to use checksums
1f56728a5c6202aea90a41cac3ee2a3082be6997156cba8a4f62e9292b5e7cbd
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 Oct 24, 2026.

Transparency log

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

Download URL anki_addons_mcp-0.8.0-py3-none-any.whl
Size 61.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b765701dae18c9556aba827d64dada27e789cd7cca8742a4ce028cb83f65863f
BLAKE2b-256 checksum
How to use checksums
bf6f6f64a90c0ad273d23dbd8a497c9532d6dd81fb199313bf0ee25f73d17a48
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 Oct 24, 2026.

Transparency log

Security for anki-addons-mcp 0.8.0

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.8.0.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 Oct 24, 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