Anki MCP Server

Instructions

Implementation Reference

• src/anki_mcp/tools/find_notes.py:5-58 (handler)

  The handler function for the 'find-notes' tool. It sends a 'notesInfo' request to Anki with the query, processes the notes by formatting fields, tags, and modification time, and returns formatted text content.

  async def find_notes(query: str) -> list[types.TextContent]:
      result = await make_anki_request("notesInfo", query=query)
      
      if result["success"]:
          notes = result["result"]
          
          if not notes:
              return [
                  types.TextContent(
                      type="text",
                      text=f"No notes found matching query: '{query}'",
                  )
              ]
          
          notes_info = []
          for note in notes:
              note_id = note["noteId"]
              model_name = note["modelName"]
              tags = ", ".join(note["tags"]) if note["tags"] else "(no tags)"
              
              # Format fields
              fields_text = []
              for field_name, field_data in note["fields"].items():
                  field_value = field_data["value"]
                  # Truncate very long field values for display
                  if len(field_value) > 100:
                      field_value = field_value[:97] + "..."
                  fields_text.append(f"  - {field_name}: {field_value}")
              
              # Format modification time
              mod_time = datetime.fromtimestamp(note["mod"]).strftime("%Y-%m-%d %H:%M:%S")
              
              note_text = (
                  f"Note ID: {note_id}\n"
                  f"Model: {model_name}\n"
                  f"Tags: {tags}\n"
                  f"Modified: {mod_time}\n"
                  f"Fields:\n" + "\n".join(fields_text) + "\n"
              )
              notes_info.append(note_text)
          
          return [
              types.TextContent(
                  type="text",
                  text=f"Found {len(notes)} notes matching query: '{query}'\n\n" + "\n\n".join(notes_info),
              )
          ]
      else:
          return [
              types.TextContent(
                  type="text",
                  text=f"Failed to retrieve notes: {result['error']}",
              )
          ]

• src/anki_mcp/server.py:14-14 (registration)

  Registers the 'find-notes' tool with the FastMCP app, linking it to the find_notes handler function.

  app.tool(name='find-notes', description='Find notes matching a query in Anki')(find_notes)

• src/anki_mcp/tools/find_notes.py:5-5 (schema)

  Type annotations define the input schema (query: str) and output schema (list[types.TextContent]) for the tool.

  async def find_notes(query: str) -> list[types.TextContent]: