Todoist MCP Server

Instructions

Implementation Reference

• src/tools/comments.ts:22-38 (handler)

  The handler function for the 'get_task_comments' MCP tool. It validates input, calls the getTaskComments service, and formats the response as MCP content.
  handler: async (args: { task_id: string }) => { console.error('Executing get_task_comments...'); const { task_id } = args; if (!task_id) { throw new Error('task_id is required'); } const result = await getTaskComments(task_id); console.error('get_task_comments completed successfully'); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; },
• src/tools/comments.ts:7-21 (schema)

  The schema definition for the 'get_task_comments' tool, including name, description, and input schema requiring 'task_id'.
  schema: { name: 'get_task_comments', description: 'Get all comments for a specific Todoist task. Returns structured JSON data with comment details including id, content, posted date, user ID, and any attachments.', inputSchema: { type: 'object', properties: { task_id: { type: 'string', description: 'The ID of the task to get comments for', }, }, required: ['task_id'], }, },
• src/handlers/tool-request-handler.ts:50-64 (registration)

  Registration of the tool handler in the toolsWithArgs registry, mapping 'get_task_comments' to getTaskCommentsTool.handler for execution.
  const toolsWithArgs: Record<string, (args: any) => Promise<ToolResponse>> = { get_task_comments: getTaskCommentsTool.handler, create_project_label: createProjectLabelTool.handler, create_task_comment: createTaskCommentTool.handler, update_task: updateTaskTool.handler, create_task: createTaskTool.handler, move_task: moveTaskTool.handler, get_tasks_with_label: getTasksWithLabelTool.handler, complete_task: completeTaskTool.handler, uncomplete_task: uncompleteTaskTool.handler, search_tasks: searchTasksTool.handler, search_tasks_using_and: searchTasksUsingAndTool.handler, search_tasks_using_or: searchTasksUsingOrTool.handler, complete_becky_task: completeBeckyTaskTool.handler, };
• src/index.ts:82-82 (registration)

  Registration of the tool schema in the ListToolsRequestHandler response array.
  getTaskCommentsTool.schema,
• src/services/tasks/comments.ts:70-94 (helper)

  The core getTaskComments helper function that fetches comments from the Todoist API using the client, maps the response, and handles errors.
  export async function getTaskComments( taskId: string ): Promise<CommentsResponse> { const todoistClient = getTodoistClient(); try { const response = await todoistClient.get<TodoistComment[]>( `/comments?task_id=${taskId}` ); const comments = response.data.map((comment) => ({ id: parseInt(comment.id), content: comment.content, posted: comment.posted, posted_uid: comment.posted_uid, attachment: comment.attachment, })); return { comments, total_count: comments.length, }; } catch (error) { throw new Error(`Failed to get task comments: ${getErrorMessage(error)}`); } }