MCP Todoist

Instructions

Implementation Reference

• packages/mcp-server/server/mcp-handler.ts:288-297 (handler)

  MCP protocol handler for 'todoist_get_tasks' tool. Dispatches to TodoistClient.getTasks with input arguments and returns the result as JSON-formatted text content.
  case 'todoist_get_tasks': const tasks = await this.todoistClient.getTasks(args) return this.createResponse(requestId, { content: [ { type: 'text', text: JSON.stringify(tasks, null, 2) } ] })
• packages/mcp-server/server/mcp-handler.ts:49-60 (schema)

  Tool schema definition including input schema for parameters like project_id, filter, and limit. Used in tools/list response.
  { name: 'todoist_get_tasks', description: 'Get tasks from Todoist', inputSchema: { type: 'object', properties: { project_id: { type: 'string', description: 'Project ID to filter tasks' }, filter: { type: 'string', description: 'Filter expression' }, limit: { type: 'number', description: 'Maximum number of tasks to return' } } } },
• packages/mcp-server/server/mcp-handler.ts:18-28 (registration)

  Tool visibility configuration where todoist_get_tasks is set to true (enabled/registered for use). Controls which tools are exposed via tools/list.
  const TOOL_VISIBILITY = { todoist_get_tasks: true, todoist_create_task: true, todoist_update_task: true, todoist_close_task: true, todoist_get_projects: true, todoist_create_project: false, // 非公開 todoist_update_project: false, // 非公開 todoist_delete_project: false, // 非公開 todoist_move_task: true, } as const
• packages/mcp-server/src/adapters/todoist-client.ts:121-123 (helper)

  Core implementation of getTasks in TodoistClient adapter. Makes authenticated GET request to Todoist API /tasks endpoint with optional params.
  async getTasks(params?: GetTasksParams): Promise<TodoistTask[]> { return this.makeRequest<TodoistTask[]>('GET', '/tasks', undefined, params); }
• packages/mcp-server/src/types/todoist.ts:40-47 (schema)

  TypeScript interface defining input parameters for getTasks, matching the tool's inputSchema.
  export interface GetTasksParams { project_id?: string; section_id?: string; label?: string; filter?: string; lang?: string; ids?: number[]; }