pengpongpang/anki-mcp-server

Anki MCP Server

An MCP server implementation that connects to a locally running Anki, providing card review and creation.

This server is designed to work with the Anki desktop app and the Anki-Connect add-on.

Make sure you have the add-on installed before using.

Resources

• anki://search/deckcurrent
  • Returns all cards from current deck
  • Equivalent of deck:current in Anki
• anki://search/isdue
  • Returns cards in review and learning waiting to be studied
  • Equivalent of is:due in Anki
• anki://search/isnew
  • Returns all unseen cards
  • Equivalent of is:new in Anki

Tools

• update_cards

  • Marks cards with given card IDs as answered and gives them an ease score between 1 (Again) and 4 (Easy)
  • Inputs:
    • answers (array): Array of objects with cardId (number) and ease (number) fields

• add_card

  • Creates a new card in the Default Anki deck
  • Inputs:
    • front (string): Front of card
    • back (string): Back of card

• get_due_cards

  • Returns n number of cards currently due for review
  • Inputs:
    • num (number): Number of cards

• get_new_cards

  • Returns n number of cards from new
  • Inputs:
    • num (number): Number of cards

Development

Install dependencies:

npm install

Build the server:

npm run build

Start the server:

npm start

SSE

SSE URL: http://localhost:3001/sse