Todoist MCP Server

Instructions

Implementation Reference

• src/tools/projects.ts:23-43 (handler)

  The async handler function that executes the 'get_inbox_projects' tool logic. It calls the getInboxProjects service function, formats the result as JSON text content, and handles errors.

  handler: async () => {
    console.error('Executing get_inbox_projects...');
    try {
      const result = await getInboxProjects();
      console.error('get_inbox_projects completed successfully');
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(result, null, 2),
          },
        ],
      };
    } catch (error) {
      throw new Error(
        `Failed to get inbox projects: ${
          error instanceof Error ? error.message : 'Unknown error'
        }`
      );
    }
  },

• src/tools/projects.ts:13-22 (schema)

  The schema definition for the 'get_inbox_projects' tool, including name, description, and empty input schema (no parameters required).

  schema: {
    name: 'get_inbox_projects',
    description:
      'Get the three inbox projects: Inbox, Brian inbox - per Becky, and Becky inbox - per Brian',
    inputSchema: {
      type: 'object',
      properties: {},
      required: [],
    },
  },

• src/handlers/tool-request-handler.ts:74-74 (registration)

  Registration of the tool handler in the toolsWithoutArgs registry map, which dispatches tool calls without arguments to the correct handler.

  get_inbox_projects: getInboxProjectsTool.handler,

• src/index.ts:90-90 (registration)

  The tool schema is registered in the server's ListTools response, making it discoverable by MCP clients.

  getInboxProjectsTool.schema,

• src/services/project-filters.ts:65-78 (helper)

  Helper service function that implements the core logic: lists all projects and filters for inbox projects using isInboxProject utility.

  export async function getInboxProjects(): Promise<ProjectsResponse> {
    try {
      const allProjects = await listProjects();
  
      const filteredProjects = allProjects.projects.filter(isInboxProject);
  
      return {
        projects: filteredProjects,
        total_count: filteredProjects.length,
      };
    } catch (error) {
      throw new Error(`Failed to get inbox projects: ${getErrorMessage(error)}`);
    }
  }