Anki MCP Server

🚀 Anki MCP Server

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

This server is designed to integrate with the Anki desktop app and the Anki-Connect add-on. Please ensure the add-on is installed before use.

🚀 Quick Start

Prerequisites

• Install the Anki-Connect add-on in your Anki desktop app.

Installation

Install the project dependencies:

npm install

Build

Build the server:

npm run build

Start the Server

Start the server:

npm start

✨ Features

Resources

• anki://search/deckcurrent
  • Returns all cards from the current deck.
  • Equivalent of deck:current in Anki.
• anki://search/isdue
  • Returns cards in review and learning that are 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 the given card IDs as answered and assigns them an ease score between 1 (Again) and 4 (Easy).
  • Inputs:
    • answers (array): An array of objects with cardId (number) and ease (number) fields.

• add_card

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

• get_due_cards

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

• get_new_cards

  • Returns n number of new cards.
  • Inputs:
    • num (number): The number of cards.

🔧 Technical Details

SSE

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