Claude Todo MCP Server

Instructions

Implementation Reference

• src/server.py:44-60 (handler)

  MCP tool handler for TodoRead: calls todo_read() and wraps with error handling.
  @mcp.tool async def TodoRead() -> dict[str, Any]: """ Read the current task list. Returns a list of todos with their current state. """ try: return await todo_read() except Exception as e: return { "error": { "code": "READ_ERROR", "message": f"Failed to read todos: {str(e)}", } }
• src/tools/todo_read.py:5-16 (helper)

  Core helper function that reads the todo list from the store and returns it as TodoReadResponse.
  async def todo_read() -> TodoReadResponse: """ Read the current task list. Returns: TodoReadResponse with list of todos """ # Read todos todos = await store.read_todos() # Return response return {"todos": todos}
• src/types.py:32-34 (schema)

  Type definition for the TodoRead response schema.
  class TodoReadResponse(TypedDict): todos: list[Todo]
• src/types.py:17-25 (schema)

  Todo item schema used in TodoReadResponse.
  class Todo(TypedDict): id: str content: str status: TodoStatus priority: TodoPriority created_at: str updated_at: str metadata: dict[str, Any] | None
• src/server.py:44-44 (registration)

  Registration of the TodoRead tool using @mcp.tool decorator.
  @mcp.tool