Todoist MCP Server

Instructions

Args:
    name: The name of the project
    parent_id: Parent project ID (for nested projects)
    color: Project color
    is_favorite: Whether to mark as favorite

Implementation Reference

• todoist_mcp/server.py:279-312 (handler)

  MCP tool handler for 'create_project': registers the tool, defines input schema via arguments, checks client, prepares kwargs, calls TodoistClient.create_project, and returns formatted success message with project details.

  @mcp.tool()
  async def create_project(
      name: str,
      parent_id: Optional[str] = None,
      color: Optional[str] = None,
      is_favorite: bool = False
  ) -> str:
      """Create a new project in Todoist.
      
      Args:
          name: The name of the project
          parent_id: Parent project ID (for nested projects)
          color: Project color
          is_favorite: Whether to mark as favorite
      """
      _check_client()
      
      kwargs = {"name": name}
      if parent_id:
          kwargs["parent_id"] = parent_id
      if color:
          kwargs["color"] = color
      if is_favorite:
          kwargs["is_favorite"] = is_favorite
          
      project = await todoist_client.create_project(**kwargs)
      
      return (
          f"Project created successfully!\n"
          f"ID: {project.id}\n"
          f"Name: {project.name}\n"
          f"URL: {project.url}"
      )

• todoist_mcp/client.py:164-168 (helper)

  Core implementation in TodoistClient: constructs payload from name and kwargs, makes POST request to Todoist API /projects endpoint, parses response into TodoistProject model.

  async def create_project(self, name: str, **kwargs) -> TodoistProject:
      """Create a new project."""
      payload = {"name": name, **kwargs}
      data = await self._request("POST", "/projects", json=payload)
      return TodoistProject(**data)

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

  Pydantic model for TodoistProject used to validate and type the project data returned from API.

  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:279-279 (registration)

  Registration decorator @mcp.tool() that registers the create_project function as an MCP tool.

  @mcp.tool()