Flashdeck

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 3, 2026

Flashcard decks and spaced repetition via AnkiConnect: study, decks, notes, and stats.

VerifiedSTDIODesktop only

Overview

Flashdeck's local MCP server; no sign-in required; STDIO.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open Flashdeck in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

flashdeck

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.

Install

bash
npx @reneturcios/flashdeck check

Or run the container image:

bash
docker run -i ghcr.io/cloudcorprecords/flashdeck

The 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.

CLI

bash
flashdeck check           # probe AnkiConnect (deck list on success)flashdeck decks           # list decksflashdeck due [deck]      # due cards, optionally for one deckflashdeck stats [deck]    # deck stats, or collection stats with no deckflashdeck tags            # all tagsflashdeck models          # all note typesflashdeck sync            # sync with AnkiWebflashdeck --version

Most commands accept --json. Exit codes: 0 success, 1 error (the message names the AnkiConnect or validation problem), 2 usage error.

MCP server

bash
npx -y @reneturcios/flashdeck mcp

MCP client configuration:

json
{  "mcpServers": {    "flashdeck": {      "command": "npx",      "args": ["-y", "@reneturcios/flashdeck", "mcp"]    }  }}

Tools

ToolInputWhat it does
sync—Sync with AnkiWeb.
get_due_cardsdeck?, include_answer?Due cards, optional deck filter; answers omitted unless requested.
get_cardsdeck?, state?, include_answer?Cards filtered by state (due/new/learning/suspended/buried) and deck.
present_cardcard_idShow a card's question/front.
rate_cardcard_id, ease (1-4)Rate Again/Hard/Good/Easy and schedule next review.
listDecksinclude_stats?List decks, optional per-deck stats.
deckStatsdeckStatistics for one deck.
createDeckdeckCreate a deck (Parent::Child, max 2 levels).
addNotedeck_name, model_name, fields, tags?Create one note.
addNotesdeck_name, model_name, notesBatch-create up to 100 notes.
findNotesquerySearch notes with Anki query syntax.
notesInfonotesDetails for notes.
updateNoteFieldsnote_id, fieldsUpdate a note's fields.
deleteNotesnotes, confirm?Delete notes; refused without confirm: true.
getTags—All tags.
addTagsnotes, tagsAdd tags to notes.
removeTagsnotes, tagsRemove tags from notes.
modelNames—List note types.
modelFieldNamesmodel_nameField names for a note type.
collection_stats—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.

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, fake fetch only, no live Ankinpm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

Source: README.md at commit 143684d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestNov 3, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts