Todoist MCP Server

Instructions

Implementation Reference

• src/tools/comments.ts:62-107 (handler)

  The handler function that executes the create_task_comment tool logic, invoking the service function and returning structured JSON response.
  handler: async (args: { task_id: string; content: string }) => { try { const comment = await createTaskComment(args.task_id, args.content); return { content: [ { type: 'text', text: JSON.stringify( { success: true, message: 'Comment created successfully', comment: { id: comment.id, content: comment.content, posted: comment.posted, posted_uid: comment.posted_uid, attachment: comment.attachment, }, }, null, 2 ), }, ], }; } catch (error) { return { content: [ { type: 'text', text: JSON.stringify( { success: false, message: 'Failed to create comment', error: error instanceof Error ? error.message : 'Unknown error', }, null, 2 ), }, ], }; } }, };
• src/tools/comments.ts:43-61 (schema)

  The schema definition for the create_task_comment tool, including name, description, and input schema.
  schema: { name: 'create_task_comment', description: 'Create a new comment on a specific Todoist task. The comment will automatically include a signature indicating it was created using Claude.', inputSchema: { type: 'object', properties: { task_id: { type: 'string', description: 'The ID of the task to add a comment to', }, content: { type: 'string', description: 'The content of the comment to add', }, }, required: ['task_id', 'content'], }, },
• src/handlers/tool-request-handler.ts:50-64 (registration)

  Registration of the create_task_comment handler in the toolsWithArgs registry used by handleToolRequest.
  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/services/tasks/comments.ts:97-107 (helper)

  The service helper function that creates a Todoist task comment with an appended Claude signature, delegating to createCommentInternal.
  export async function createTaskComment( taskId: string, content: string ): Promise<CommentResult> { try { const commentContent = `${content}\n\n*(commented using Claude)*`; return await createCommentInternal(taskId, commentContent); } catch (error) { throw new Error(`Failed to create task comment: ${getErrorMessage(error)}`); } }