MCP Todoist

Instructions

Implementation Reference

• packages/mcp-server/server/mcp-handler.ts:332-341 (handler)

  MCP tool handler for 'todoist_get_projects' which fetches projects using TodoistClient and returns them as JSON string.

  case 'todoist_get_projects':
    const projects = await this.todoistClient.getProjects()
    return this.createResponse(requestId, {
      content: [
        {
          type: 'text',
          text: JSON.stringify(projects, null, 2)
        }
      ]
    })

• packages/mcp-server/server/mcp-handler.ts:106-112 (schema)

  Tool schema definition for todoist_get_projects, including empty input schema.

    name: 'todoist_get_projects',
    description: 'Get projects from Todoist',
    inputSchema: {
      type: 'object',
      properties: {}
    }
  },

• packages/mcp-server/server/mcp-handler.ts:23-23 (registration)

  Tool visibility registration enabling todoist_get_projects.

  todoist_get_projects: true,

• packages/mcp-server/src/adapters/todoist-client.ts:140-142 (helper)

  TodoistClient helper method that makes API call to fetch projects.

  async getProjects(): Promise<TodoistProject[]> {
    return this.makeRequest<TodoistProject[]>('GET', '/projects');
  }

• packages/mcp-server/src/types/todoist.ts:25-38 (schema)

  TypeScript interface defining the TodoistProject type returned by getProjects.

  export interface TodoistProject {
    id: string;
    name: string;
    comment_count: number;
    order: number;
    color: string;
    is_shared: boolean;
    is_favorite: boolean;
    is_inbox_project: boolean;
    is_team_inbox: boolean;
    view_style: string;
    url: string;
    parent_id: string | null;
  }