Reported issues for AnkiMCP Server
Pod holds 18 of 19 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.
Back to AnkiMCP Server.
Most discussed
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
### 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
### QueueBridge: shared response_queue misroutes responses under concurrent callers (Asked claude to write copy/paste bcz i'm a beginner)
<head></head><h1 id="github-issue-draft-E28094-response-routing-bug" data-orig-id="github-issue-draft-%E2%80%94-response-routing-bug" style="font-style: normal; font-variant-caps: normal; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-line: none; text-decoration-thickness: auto; text-decoration-style: solid; margin-top: 1.5em; margin-bottom: 0.5em; li
[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/21) · 2026-03-07 · closed · external user · 8 comments
### "Create Filtered Deck" Action
Can you add a feature for "creating filtered decks"? I use Claude and integrate Claude into a lot of the card tagging andwhatnot and search but i have to manually create filtered decks by copying and pasting and doing it through anki. Would this be a possible feature? I don't know if this is the right place to post this (I'm new to github) and I navigated here from the anki mcp server addon webpage when i clicked contact but i wanted to ask for this feature.
Best,
[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/18) · 2026-02-26 · closed · external user · 2 comments
### FR: Expose field descriptions
Hi, I inspected the code and experimented with agents, and it seems that currently, the `modelFieldNames` and `notesInfo` tools do not provide field descriptions:
<img width="736" height="597" alt="Image" src="https://github.com/user-attachments/assets/d2fe7363-b266-4527-aa80-c081f1cf531b" />
Would you please consider exposing this property, e.g. like a dictionary or list of objects that includes the description if one exists:
```json
{
"model_name": "Vocabulary",
"fields": [
{
[Read the thread](https://github.com/ankimcp/anki-mcp-server-addon/issues/15) · 2026-02-23 · closed · external user · 2 comments
### Installation problems
Following the README to install the MCP server via editing the json doesn't work. However, following the [online guide](https://ankimcp.ai/docs/installation/desktop/) 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](https://github.com/ankimcp/anki-mcp-server-addon/issues/13) · 2026-02-08 · closed · external user · 6 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
### 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](https://github.com/ankimcp/anki-mcp-server-addon/issues/8) · 2026-02-06 · closed · external user · 5 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
### 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
### 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
### Parameters missing for `updateNoteFields`?
█
You’re right — I should be able to update notes with the tool, but in this environment the anki-mcp_updateNoteFields function is defined without parameters, so I can’t pass the new field values programmatically.
Read the thread · 2026-03-06 · closed · external user · 2 comments
The remaining reports are on the project's issue tracker.