Anki MCP Server

Instructions

Implementation Reference

• index.ts:282-293 (handler)

  Handler for the 'get_due_cards' tool. It retrieves due cards using the helper findCardsAndOrder with query 'is:due', slices the first 'num' cards, and returns them as JSON string in the response content.

  case "get_due_cards": {
    const num = Number(args.num);
  
    const cards = await findCardsAndOrder("is:due");
  
    return {
      content: [{
        type: "text",
        text: JSON.stringify(cards.slice(0, num))
      }]
    };
  }

• index.ts:191-204 (registration)

  Registration of the 'get_due_cards' tool in the ListTools response, including name, description, and input schema requiring a 'num' parameter.

  {
    name: "get_due_cards",
    description: "Returns a given number (num) of cards due for review.",
    inputSchema: {
      type: "object",
      properties: {
        num: {
          type: "number",
          description: "Number of due cards to get"
        }
      },
      required: ["num"]
    },
  },

• index.ts:194-203 (schema)

  Input schema for the 'get_due_cards' tool, defining an object with a required 'num' number property.

  inputSchema: {
    type: "object",
    properties: {
      num: {
        type: "number",
        description: "Number of due cards to get"
      }
    },
    required: ["num"]
  },

• index.ts:93-105 (helper)

  Helper function used by the handler to find cards matching the query (e.g., 'is:due'), fetch their info, clean question and answer fields, and sort by due date.

  async function findCardsAndOrder(query: string): Promise<Card[]> {
    const cardIds = await client.card.findCards({
      query: formatQuery(query)
    });
    const cards: Card[] = (await client.card.cardsInfo({ cards: cardIds })).map(card => ({
      cardId: card.cardId,
      question: cleanWithRegex(card.question),
      answer: cleanWithRegex(card.answer),
      due: card.due
    })).sort((a: Card, b: Card) => a.due - b.due);
  
    return cards;
  }