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)}`); } }