Provides tools for studying and managing Anki flashcards through a local AnkiConnect instance, including reviewing due cards, presenting and rating cards, managing decks, notes, tags, and note types, retrieving collection statistics, and syncing with AnkiWeb.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
flashdeck lets an agent study and manage Anki flashcards through a local Anki instance running AnkiConnect. It covers the review loop (due cards, presenting a card, rating it), decks, notes, tags, note types, and collection statistics — a labelled core subset of 20 tools from the 53 documented in the original Anki MCP spec.
Anki must be running with the AnkiConnect add-on installed. By
default flashdeck talks to http://127.0.0.1:8765; set
ANKICONNECT_URL to point elsewhere.
npx @reneturcios/flashdeck checkOr run the container image:
docker run -i ghcr.io/cloudcorprecords/flashdeckThe container defaults to the MCP server. Pass CLI arguments to use it as a CLI instead. Note the container still needs network access to the host's AnkiConnect endpoint.
Related MCP server: mcp-server-anki
flashdeck check # probe AnkiConnect (deck list on success)
flashdeck decks # list decks
flashdeck due [deck] # due cards, optionally for one deck
flashdeck stats [deck] # deck stats, or collection stats with no deck
flashdeck tags # all tags
flashdeck models # all note types
flashdeck sync # sync with AnkiWeb
flashdeck --versionMost commands accept --json. Exit codes: 0 success, 1 error
(the message names the AnkiConnect or validation problem), 2
usage error.
npx -y @reneturcios/flashdeck mcpMCP client configuration:
{
"mcpServers": {
"flashdeck": {
"command": "npx",
"args": ["-y", "@reneturcios/flashdeck", "mcp"]
}
}
}Tool | Input | What it does |
| — | Sync with AnkiWeb. |
|
| Due cards, optional deck filter; answers omitted unless requested. |
|
| Cards filtered by state (due/new/learning/suspended/buried) and deck. |
|
| Show a card's question/front. |
|
| Rate Again/Hard/Good/Easy and schedule next review. |
|
| List decks, optional per-deck stats. |
|
| Statistics for one deck. |
|
| Create a deck (Parent::Child, max 2 levels). |
|
| Create one note. |
|
| Batch-create up to 100 notes. |
|
| Search notes with Anki query syntax. |
|
| Details for notes. |
|
| Update a note's fields. |
|
| Delete notes; refused without |
| — | All tags. |
|
| Add tags to notes. |
|
| Remove tags from notes. |
| — | List note types. |
|
| Field names for a note type. |
| — | Aggregated collection statistics. |
Deck statistics are computed locally from per-state card searches; no statistics endpoint is assumed. When Anki is not running, tools return an error naming the failed AnkiConnect request rather than an empty result.
npm install
npm run build # tsc -> dist/
npm test # node test runner over test/*.test.ts, fake fetch only, no live Anki
npm run dev # run the CLI from source via tsxMIT — see LICENSE.
This server cannot be deployed
Build and study spaced-repetition flashcards with your agent.
Turn text, files, URLs, or photos into Anki flashcard decks from your AI assistant.
Spaced-repetition flashcards in Markdown: create cards, manage decks and study with FSRS.
Language flashcards in your AI assistant: build decks, edit cards and review what's due in the chat.
