Todoist MCP Server

Instructions

Args:
    project_id: The ID of the project to retrieve

Implementation Reference

• todoist_mcp/server.py:257-276 (handler)

  The MCP tool handler for 'get_project'. It checks the client, fetches the project using the TodoistClient, and formats the response as a string.

  @mcp.tool()
  async def get_project(project_id: str) -> str:
      """Get a specific project by ID.
      
      Args:
          project_id: The ID of the project to retrieve
      """
      _check_client()
      
      project = await todoist_client.get_project(project_id)
      
      return (
          f"Project: {project.name}\n"
          f"ID: {project.id}\n"
          f"Color: {project.color}\n"
          f"Shared: {project.is_shared}\n"
          f"Favorite: {project.is_favorite}\n"
          f"View Style: {project.view_style}\n"
          f"URL: {project.url}"
      )

• todoist_mcp/client.py:159-162 (helper)

  The TodoistClient helper method that performs the actual API call to retrieve project details and parses it into TodoistProject model.

  async def get_project(self, project_id: str) -> TodoistProject:
      """Get a specific project by ID."""
      data = await self._request("GET", f"/projects/{project_id}")
      return TodoistProject(**data)

• todoist_mcp/client.py:27-41 (schema)

  Pydantic model defining the structure of a TodoistProject used in the tool response.

  class TodoistProject(BaseModel):
      """Represents a Todoist project."""
      id: str
      name: str
      comment_count: int = 0
      order: int = 0
      color: str = "grey"
      is_shared: bool = False
      is_favorite: bool = False
      is_inbox_project: bool = False
      is_team_inbox: bool = False
      view_style: str = "list"
      url: str = ""
      parent_id: Optional[str] = None

• todoist_mcp/server.py:257-257 (registration)

  The @mcp.tool() decorator registers the get_project function as an MCP tool.

  @mcp.tool()