pod
Other formats agents might prefer:
markdownjsonllms.txt

Agent? You probably want markdown or json, or Pod over MCP.

Reported issues for AnkiMCP Server Desktop Extension

Pod holds 20 of 31 GitHub reports that passed its relevance review. This can include external user reports, maintainer-confirmed bugs, and concrete feature gaps. Treat them as evidence to inspect, not a count of distinct defects.

Back to AnkiMCP Server Desktop Extension.

Most discussed

QueueBridge: shared response_queue misroutes responses under concurrent callers (Asked claude to write copy/paste bcz i'm a beginner)

Read the thread · 2026-03-07 · closed · external user · 8 comments

Installation problems

Following the README to install the MCP server via editing the json doesn't work. However, following the online guide does work. A word of caution is that following the online guide ends up nuking my json file for other mcp servers.

Read the thread · 2026-02-08 · closed · external user · 6 comments

Vendored uvicorn incompatible with Anki's Python 3.9

Anki 25.02.5 ships Python 3.9.18. The vendored uvicorn/_types.py uses Python 3.10+ X | Y union syntax in runtime type aliases (not annotations), which crashes on import.

File ".../vendor/shared/uvicorn/_types.py", line 45 ExcInfo = tuple[type[BaseException], BaseException, types.TracebackType | None] TypeError: unsupported operand type(s) for |: 'type' and 'NoneType'

Fix: vendor a uvicorn version that supports Python 3.9, or patch the type aliases to use Union/Optional.

Read the thread · 2026-02-06 · closed · external user · 5 comments

Accept distro versions of pydantic or force installation to another dir

Currently I have Anki installed via the official Arch repo. This addon will not work with the arch repo version of pydantic, but when I patch out the check, it will work without any problem. Please either don't make the check this strict (and accept the preinstalled version), or force using a different version you supply and import that in such a way that it doesn't interfere with the host system version.

Anki 25.09.2 (3890e12c) (ao)
Python 3.14.4 Qt 6.11.0 PyQt 6.11.0
Platform: Linux-7.0.5

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/40) · 2026-05-12 · closed · external user · 4 comments

### FR: Add secret-path option for MCP HTTP endpoint

Hi, thanks for the add-on; it’s been very useful

Could you please consider adding support for a “secret path” mode for the HTTP, e.g. serving MCP under `http://localhost:3141/secret-string/` → `https://example.com/secret-string/`, so ChatGPT MCP can connect relatively securely without requiring full OAuth?

The goal isn’t strong security, but rather avoiding exposing a fully unauthenticated MCP endpoint

Best regards

P.S. The headless Anki container is quite promising. It would be incredibly u

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/9) · 2026-02-07 · closed · external user · 4 comments

### rpds ModuleNotFoundError on Windows / Linux-aarch64 / macOS-Intel — vendored bundle ships wrong-platform binaries (exposed by Anki 26.05)

## Summary

On affected platforms the addon fails to load at startup with `ModuleNotFoundError: No module named 'rpds.rpds'`. The vendored `vendor/shared/rpds/` only contains binaries for **macOS-arm64** and **linux-x86_64**, and `rpds` (a compiled Rust extension) has no pure-Python fallback — so it can't be imported on other platforms.

Originally reported (in the wrong repo — that's the TypeScript CLI) at ankimcp/anki-mcp-server#35. Thanks to the reporter for the detailed write-up.

## Affecte

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/54) · 2026-06-19 · closed · 3 comments

### RuntimeError: Vendored pydantic/version.py not found when loading add-on in Nix environment

## Environment

- **Anki version:** 25.09.2 (3890e12c) (ao)
- **Python:** 3.13.9
- **Qt:** 6.10.1 / PyQt 6.9.0
- **Platform:** Linux 6.17.9 (x86_64, glibc 2.40)
- **Add-on version:** v0.12.0

## Nix Configuration

Nix is a declarative package manager, and so it fetches the source directly from GitHub at build time rather than using a pre-built artifact:

```nix
anki-mcp-server = (
  pkgs.anki-utils.buildAnkiAddon (finalAttrs: {
    pname = "anki-mcp-server";
    version = "v0.12.0";
    src = pk

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/36) · 2026-04-07 · closed · external user · 3 comments

### rate_card fails with 'not at top of queue' after skipping media cards

## Bug Report

Reported by LouisO on Discord.

### Description

When using `get_due_cards` with `skip_images=True` or `skip_audio=True`, the returned card may not be at the top of Anki's scheduler queue (because media cards were skipped over). When `rate_card` is then called on that card, Anki rejects it with **"not at top of queue"**.

### Steps to Reproduce

1. Have a deck with mixed cards (some with images/audio, some text-only)
2. Call `get_due_cards(deck_name="...", skip_images=True)` — thi

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/10) · 2026-02-07 · closed · 3 comments

## Most recent

### All tools fail with "invalid outputSchema... unsupported dialect" (JSON Schema draft-07 vs 2020-12)

## Summary
Every single tool call to this MCP server fails client-side with the same error,
even simple read-only calls like `listDecks`. The connection/handshake succeeds
(tool list loads fine), but every actual tool invocation is rejected when the
client tries to validate the response against the tool's declared output schema.

## Exact error message
Error: Tool '<toolName>' has an invalid outputSchema: JSON Schema declares an
unsupported dialect ("$schema": "http://json-schema.org/draft-07/sc

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/69) · 2026-08-12 · closed · external user · 2 comments

### FR: Tool to manage fields on an existing note type (add/remove/rename/reposition)

The addon can create a note type with fields (`create_model`) and read field names (`model_field_names`), but there is no tool to modify the fields of an existing note type. `update_model_templates` and `update_model_styling` only touch card templates/CSS not the field list.

## Proposed solution

 A multi-action tool (e.g. `manage_model_fields`) with an `action` discriminator, supporting:
- `add` — add a new field (optionally at a position)
- `remove` — delete a field
- `rename` — rename a fiel

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/57) · 2026-06-25 · closed · external user · 1 comment

### update_model_templates: valid templates are mutated in the live model when the call fails on an unknown template name

## Summary

`update_model_templates` (new in v0.19.0 — thanks for shipping it!) validates template **keys** (`Front`/`Back`) in a true pre-pass before touching anything, but unknown card-template **names** are only detected *inside* the mutation loop. Because `col.models.by_name()` returns the live cached notetype dict, every valid entry in the call has already mutated the in-memory note type by the time the `Card template(s) not found` error is raised. `col.models.update_dict()` is never reache

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/47) · 2026-06-11 · closed · external user · 1 comment

### Add opt-in mechanism for high-risk tools (disabled by default)

## Motivation

AI clients — **including remote tunnel clients, which are in scope for this addon** — should not be able to invoke high-risk, destructive/structural operations (deck deletion, deck rename, etc.) by default. The operator should have to explicitly opt in to expose those tools.

This came up in the PR #45 review (deck-management group, deferred): letting an AI client mutate deck structure is high-stakes enough that it must ship **off by default**, with explicit opt-in. This issue is 

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/46) · 2026-06-11 · closed · 1 comment

### FR: Make FastMCP stateless mode configurable (clients without mcp-session-id support)

Originally reported in the AnkiWeb addon comments: https://ankiweb.net/shared/info/124672614

---

> Hi, the addon uses `stateless_http=False` (default) for FastMCP, which requires clients to send `mcp-session-id` header on every request. However, not all MCP clients — including opencode's "remote" transport type — implement session ID management, so they get `"Session not found"` errors.
>
> The fix is to pass `stateless_http=True` when creating the FastMCP instance:
>
> ```python
> mcp = FastM

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/42) · 2026-05-18 · closed · 1 comment

### filtered_deck: Add get_info action to inspect search terms and configuration

## Use case

The `filtered_deck` tool supports create/update/rebuild/empty/delete, but there's no way to **read back** the configuration of existing filtered decks — specifically the search terms, limits, order, and reschedule setting.

This creates a write-only gap: agents can create filtered decks but can't programmatically verify or audit them afterward without opening the Anki GUI.

### Real-world scenarios

- **Auditing search terms across many filtered decks** — e.g., verifying 168 filtere

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/34) · 2026-03-29 · closed · external user · 0 comments

### Feature Request: `notes_info`: Add `exclude_fields` / `include_fields` parameter to control which fields are returned

### Context

When running multi-agent workflows (as described in my #21 testing), the standard pattern for pulling card data is a 2-call pipeline:

Call 1: find_notes("tag:Chapter", limit=500) → note IDs Call 2: notes_info([all IDs]) → full card content


This is efficient for call count (2 calls instead of dozens), but `notes_info` returns ALL fields for every note with no way to filter. The problem is data volume.

My Lecture Notes field is heavily used — paragraphs

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/30) · 2026-03-26 · closed · external user · 0 comments

### feat: Batch tag_management — multiple operations in one call

## Context

Requested by @asdp132A3a in [#21 (comment)](https://github.com/ankimcp/anki-mcp-server-addon/issues/21#issuecomment-4084635307). Splitting into its own issue since it's a separate feature from the concurrency fix.

## Problem

Users running mass tagging workflows make 100+ sequential `add_tags` calls — one per tag/note-set combination. Each call is a separate MCP round-trip, which adds up.

## Current behavior

`add_tags` accepts `note_ids: list[int]` + `tags: str` (space-separated).

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/28) · 2026-03-19 · closed · 0 comments

### Filtered tools

Hello, is it possible to add a configuration to filter available tools? To reduce the context the token consumption when there are unused tools

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/25) · 2026-03-12 · closed · external user · 1 comment

### Batch feature request

Hello, is it possible to add batch requests? to add multiple notes or create multiple decks at the same time

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/24) · 2026-03-12 · closed · external user · 2 comments

### Add:Tag, Modify:Tag, Remove:Tag, Replace:Tag Feature Request

Is it possible to add the Ankiconnect features of  adding tags, removing tags, modifying tags of Anki Notes with Claude Code into Anki MCP Server as well? 
I've pivoted almost my entire workflow over to Anki MCP Server and even incorpotated novel features that only Anki MCP Server has (create, modify, filtered decks).  The only thing I have to occassionally swap over to ankiconnect (sadly) is for adding, removing, modifying, replacing, tags on notes via Claude. Would it be possible to add this t

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/23) · 2026-03-12 · closed · external user · 2 comments

### Add Reschedule / Set due date tool

I love this MCP server but its missing one key feature: the ability to reschedule cards and set their due date! It would really take this MCP server to the next level and differentiate it from all the other available ones, since as far as I could find, nobody else does this.

[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/22) · 2026-03-10 · closed · external user · 1 comment

The remaining reports are on [the project's issue tracker](https://github.com/ankimcp/anki-mcp-server-addon/issues).