MCP-AnkiConnect

- random: Randomly sample notes - recent: Notes added in the last week - most_reviewed: Notes with more than 10 reviews - best_performance: Notes with less than 3 lapses - mature: Notes with interval greater than 21 days - young: Notes with interval less than 7 days Args: deck: Optional[str] - Filter by specific deck (use exact name). limit: int - Maximum number of examples to return (default 5). sample: str - Sampling technique (random, recent, most_reviewed, best_performance, mature, young).

Args: deck: Optional[str] - Filter by specific deck name. limit: int - Maximum number of cards to fetch (default 5). today_only: bool - If true, only fetch cards due today. If false, fetch cards due up to MAX_FUTURE_DAYS ahead (currently {MAX_FUTURE_DAYS}).

Args: reviews: List of review dictionaries, each with: - card_id (int): The ID of the card reviewed. - rating (str): 'wrong', 'hard', 'good', or 'easy'.

For code examples, use <code> tags to format your code. e.g. <code>def fibonacci(n): if n <= 1: return n return fibonacci(n-1) + fibonacci(n-2)</code> For MathJax, use the <math> tag to format your math equations. This will automatically render the math equations in Anki. # e.g. <math>\frac{d}{dx}[3\sin(5x)] = 15\cos(5x)</math> Args: deckName: str - The target deck name. modelName: str - The note type (model) name. fields: dict - Dictionary of field names and their string content. tags: List[str] - Optional list of tags.

This tool allows you to find existing notes/flashcards using Anki's query language. Results include note IDs which can be used for follow-up actions. ## Common Search Patterns **Simple text search:** - `dog` - notes containing "dog" (matches "doggy", "underdog") - `dog cat` - notes with both "dog" AND "cat" - `dog or cat` - notes with "dog" OR "cat" - `-cat` - notes WITHOUT "cat" - `"a dog"` - exact phrase match - `w:dog` - whole word match only **Field-specific search:** - `front:dog` - Front field exactly equals "dog" - `front:*dog*` - Front field contains "dog" - `front:` - Front field is empty - `front:_*` - Front field is non-empty **Deck and tag filters:** - `deck:French` - cards in French deck (including subdecks) - `deck:French -deck:French::*` - only top-level French deck - `tag:vocab` - notes with "vocab" tag - `tag:none` - notes without any tags - `note:Basic` - notes using "Basic" note type **Card state:** - `is:due` - cards due for review - `is:new` - new cards not yet studied - `is:learn` - cards in learning phase - `is:review` - review cards - `is:suspended` - suspended cards - `is:buried` - buried cards **Card properties:** - `prop:ivl>=10` - interval >= 10 days - `prop:due=0` - due today - `prop:due=1` - due tomorrow - `prop:lapses>3` - lapsed more than 3 times - `prop:ease<2.5` - easier than default - `prop:reps<10` - reviewed fewer than 10 times **Recent activity:** - `added:7` - added in last 7 days - `edited:3` - edited in last 3 days - `rated:1` - answered today - `rated:7:1` - answered "Again" in last 7 days - `introduced:30` - first answered in last 30 days **Combining searches:** - `deck:Spanish tag:verb is:due` - due Spanish verbs - `added:7 -is:review` - new cards added this week - `(dog or cat) deck:Animals` - dog or cat in Animals deck Args: query: The Anki search query string. limit: Maximum notes to return (1-100, default 20). Returns: JSON array of matching notes with their fields, tags, and note IDs.