English Français العربية

io.github.CloudCorpRecords/flashdeck

Official registry Other

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @reneturcios/flashdeck
Claude Code 
claude mcp add flashdeck -- npx -y @reneturcios/flashdeck@0.1.0 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "flashdeck": {
            "command": "npx",
            "args": [
                "-y",
                "@reneturcios/flashdeck@0.1.0",
                "mcp"
            ]
        }
    }
}
OCI package ghcr.io/cloudcorprecords/flashdeck:0.1.0
Claude Code 
claude mcp add flashdeck -- docker run -i --rm ghcr.io/cloudcorprecords/flashdeck:0.1.0 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "flashdeck": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/cloudcorprecords/flashdeck:0.1.0",
                "mcp"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. flashdeck
  2. Install
  3. CLI
  4. MCP server
  5. Development
  6. License

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

npx @reneturcios/flashdeck check

Or run the container image:

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

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 --version

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

MCP server

npx -y @reneturcios/flashdeck mcp

MCP client configuration:

{
  "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

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 tsx

License

MIT — see LICENSE.

Frequently asked questions

What is io.github.CloudCorpRecords/flashdeck?

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

How do I install io.github.CloudCorpRecords/flashdeck?

It runs on your machine. In Claude Code: claude mcp add flashdeck -- npx -y @reneturcios/flashdeck@0.1.0 mcp. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.CloudCorpRecords/flashdeck need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.CloudCorpRecords/flashdeck open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.CloudCorpRecords/flashdeck?

It is published by CloudCorpRecords. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.