add_noteLABSCO SUMMARY
Anki's action list, reachable from the conversation that produced the cards.
Because it mirrors AnkiConnect action for action, the shape is the API's rather than a study workflow's: create_flashcard is the one convenience, and everything richer goes through add_note with a note type and named fields you have to look up first. The GUI half acts on the app on screen, which is the point when you want a person to see the deck, and worth remembering when the card you answer is whichever one is showing.
What it is
A bridge to a running Anki desktop, 46 tools mirroring AnkiConnect actions across decks, note types, notes, cards, tags and the reviewer windows.
What you get
- Notes added singly or in batches with a deck, note type, fields, tags and audio, and can_add_notes to check them before they are written
- create_flashcard for the plain case, taking just a front and a back
- Search by Anki query string in two directions — find_notes and find_cards — then bulk detail through notes_info and cards_info
- Scheduling state read and changed: suspend, unsuspend, are_suspended, are_due and get_intervals
- The reviewer driven step by step: open a deck for review, show question, show answer, answer with an ease, start the card timer
- Anki's own windows opened where a person needs to look — the browser with a search query, the deck browser, a deck overview, the add-cards dialog
- Deck inventory and moves: names, names with ids, the cards in a deck, moving cards between decks, deleting decks
- Deck option groups cloned, saved, assigned to decks and removed
- Note types inspected before you write to them, down to field names and which fields appear on which templates
- Tags listed and added to or removed from a set of notes, and multi to batch several actions into one call
Requirements
Anki running on this machine with AnkiConnect reachable. There is no account or key: the reviewer and browser tools act on the application in front of you, and gui_exit_anki closes it.
Setup effort
One command — npx @spacholski1225/anki-connect-mcp
USE CASES
01
Turning a reading session into cards that fit your existing decks
Check which decks and note types exist and what fields those note types expect, test the notes before writing them so a duplicate or a bad field name fails cheaply, then add the batch in one call.
02
Making a quick card without picking a note type
The convenience path takes a front and a back and nothing else, for when the card came out of the conversation you are already having and the deck's structure is not the question.
03
Cleaning up a deck that has drifted
Find the notes with an Anki search query, read their current fields in bulk, correct the ones that are wrong, and strip the tags that no longer apply across the whole set at once.
04
Checking what is due before you sit down to study
Search the cards you care about, ask which of them are actually due, and read their intervals to see whether tomorrow is about to be much heavier than today.
05
Putting a set of cards on hold before a trip
Select the cards by query, suspend them so they stop appearing in reviews, and confirm the suspension took — then unsuspend the same set when you are back.
06
Reviewing from the chat while Anki stays on screen
Open the deck in Anki's reviewer, show the question and then the answer in the window in front of you, and grade the card with an ease — the app and the conversation stay on the same card.
46 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
add_notesadd_tagsare_dueare_suspendedcan_add_notescards_infocards_to_noteschange_deckclone_deck_config_idcreate_flashcarddeck_namesdeck_names_and_idsdelete_decksfind_cardsfind_notesget_deck_configget_decksget_intervalsget_tagsgui_add_cardsgui_answer_cardgui_browsegui_current_cardgui_deck_browsergui_deck_overviewgui_deck_reviewgui_exit_ankigui_show_answergui_show_questiongui_start_card_timermodel_field_namesmodel_fields_on_templatesmodel_namesmodel_names_and_idsmultinotes_inforemove_deck_config_idremove_tagssave_deck_configset_deck_config_idsuspendunsuspendupdate_note_fieldsupgradeversionBEFORE YOU INSTALL
What to know first
Tools you get
46 tools when we connected.
Requires
- npx on PATH
- Anki desktop running, with the AnkiConnect add-on installed (add-on code 2055492159)
CONTEXT COST
Light Standing cost
Rated by the size of the 46 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"anki-connect-mcp": {
"command": "npx",
"args": [
"@spacholski1225/anki-connect-mcp"
]
}
}
}npx
TERMINAL
npx @spacholski1225/anki-connect-mcp
