Enhanced Todoist MCP Server Extended

Instructions

Implementation Reference

• src/index.ts:1356-1377 (handler)

  Handler implementation for the 'todoist_get_projects' tool. Validates input with isProjectArgs, fetches projects from Todoist API using todoistClient.getProjects with pagination params, formats output with formatProject, and returns formatted list with next cursor.

  if (name === "todoist_get_projects") {
    if (!isProjectArgs(args)) {
      throw new Error("Invalid arguments for todoist_get_projects");
    }
    
    const params: any = {};
    if (args.cursor) params.cursor = args.cursor;
    if (args.limit) params.limit = args.limit;
  
    const projectsResponse = await todoistClient.getProjects(params);
    
    const projectList = projectsResponse.results?.map(formatProject).join('\n\n') || 'No projects found';
    const nextCursor = projectsResponse.nextCursor ? `\n\nNext cursor: ${projectsResponse.nextCursor}` : '';
    
    return {
      content: [{ 
        type: "text", 
        text: `Projects:\n${projectList}${nextCursor}` 
      }],
      isError: false,
    };
  }

• src/index.ts:364-381 (schema)

  Schema definition for the 'todoist_get_projects' tool, specifying name, description, and input schema for optional pagination parameters (cursor and limit).

  const GET_PROJECTS_TOOL: Tool = {
    name: "todoist_get_projects",
    description: "Get all active projects with pagination support",
    inputSchema: {
      type: "object",
      properties: {
        cursor: {
          type: "string",
          description: "Pagination cursor for next page (optional)"
        },
        limit: {
          type: "number",
          description: "Maximum number of projects to return (default: 50, max: 200) (optional)",
          default: 50
        }
      }
    }
  };

• src/index.ts:1083-1121 (registration)

  Registration of the 'todoist_get_projects' tool (as GET_PROJECTS_TOOL) in the list of available tools returned by ListToolsRequestSchema handler.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: [
      // Task tools
      CREATE_TASK_TOOL,
      QUICK_ADD_TASK_TOOL,
      GET_TASKS_TOOL,
      GET_TASK_TOOL,
      UPDATE_TASK_TOOL,
      DELETE_TASK_TOOL,
      COMPLETE_TASK_TOOL,
      REOPEN_TASK_TOOL,
      SEARCH_TASKS_TOOL,
      MOVE_TASK_TOOL,
      BULK_MOVE_TASKS_TOOL,
      // Project tools
      GET_PROJECTS_TOOL,
      GET_PROJECT_TOOL,
      CREATE_PROJECT_TOOL,
      UPDATE_PROJECT_TOOL,
      DELETE_PROJECT_TOOL,
      // Section tools
      GET_SECTIONS_TOOL,
      CREATE_SECTION_TOOL,
      UPDATE_SECTION_TOOL,
      DELETE_SECTION_TOOL,
      // Label tools
      CREATE_LABEL_TOOL,
      GET_LABEL_TOOL,
      GET_LABELS_TOOL,
      UPDATE_LABEL_TOOL,
      DELETE_LABEL_TOOL,
      // Comment tools
      CREATE_COMMENT_TOOL,
      GET_COMMENT_TOOL,
      GET_COMMENTS_TOOL,
      UPDATE_COMMENT_TOOL,
      DELETE_COMMENT_TOOL,
    ],
  }));

• src/index.ts:722-724 (helper)

  Helper function formatProject used in the handler to format individual project details for output.

  function formatProject(project: any): string {
    return `- ${project.name}${project.color ? `\n  Color: ${project.color}` : ''}${project.isFavorite ? `\n  Favorite: Yes` : ''}${project.viewStyle ? `\n  View: ${project.viewStyle}` : ''}${project.parentId ? `\n  Parent: ${project.parentId}` : ''}${project.id ? ` (ID: ${project.id})` : ''}`;
  }

• src/index.ts:815-821 (helper)

  Type guard helper isProjectArgs used in the handler to validate input arguments for pagination.

  function isProjectArgs(args: unknown): args is {
    cursor?: string;
    limit?: number;
  } {
    // Allows empty object or object with optional cursor/limit
    return typeof args === "object" && args !== null;
  }