TODO MCP Server Reference: Every Tool, Setup and Example Prompts (2026)

Updated 15 October 2026

Short answer: TODO has a built-in remote MCP server with 24 tools covering the daily pad, the weekly pad, lists, subtasks, search and task results. Any MCP client that supports remote servers with OAuth (Claude, ChatGPT, Claude Code, Codex, Cursor) can connect. Copy your connection URL from the MCP setup page, sign in, approve access, and the assistant works on the same tasks you see in the app.

The Basics

Transport: remote MCP over HTTP. Nothing to install or run on your computer.
Sign-in: OAuth. You approve access once on a TODO consent screen. There is no API key to copy.
Scope: only your own tasks, plus lists other people have shared with you.
Activity: the MCP page shows which assistants are connected and what they changed.
Price: included free with every TODO account.

Every Tool

Planning and search

Feature	What it does
get_today	Everything on a day: daily tasks with subtasks and notes, plus that week's weekly tasks
find_tasks	Search titles and notes across every pad, including shared lists
get_task_detail	Full notes, subtasks and attachments for one task, with links to open each file

Daily pad

Feature	What it does
list_daily_tasks	Tasks for a date or date range
add_daily_task	Add a task for a day, with notes, priority, repeat and subtasks
update_daily_task	Change the title, notes, date, priority or repeat
complete_daily_task	Tick off (or un-tick) a task; repeating tasks are completed for the right date
delete_daily_task	Delete a task after confirming with you

Weekly pad

Feature	What it does
list_weekly_tasks	Tasks for a Monday to Sunday week
add_weekly_task	Add a task to a week
update_weekly_task	Edit a weekly task or move it to another week
complete_weekly_task	Tick off a weekly task
delete_weekly_task	Delete a weekly task after confirming

Lists

Feature	What it does
list_lists	Your lists with open and completed counts
list_list_tasks	Tasks in one list, by id or name
add_list_task	Add a task to a list, creating the list if you ask for a new one
update_list_task	Edit a list task, set a due date or move it to another list
complete_list_task	Tick off a list task
delete_list_task	Delete a list task after confirming

Subtasks and results

Feature	What it does
add_subtask	Add subtasks under any task
complete_subtask	Tick off a subtask
delete_subtask	Delete a subtask after confirming
add_task_context	Save answers you give (steps, people, deadline) onto the task
log_task_result	Record what the assistant did, with links, and complete the task when it is done

How Assistants Decide Whether to Do a Task

The server tells assistants to read a task's notes and attachments before doing anything. A task is only treated as ready when five things are clear: the steps, the apps or accounts involved, the people, what done looks like, and the timeline. If any are missing, the assistant asks you in one short message instead of guessing, then saves your answers onto the task with add_task_context.

To make tasks easy to hand over, write the notes like this:

Context: why it matters.
Steps: what to do, in order.
Inputs: links, files, names and exact values.
Done when: how you'll know it's finished.

Connect in Two Minutes

Sign in to TODO and open the MCP setup page. Copy your connection URL.
Add it as a custom connector in your assistant. Step-by-step guides: Claude Code and Cowork, ChatGPT, Codex.
Sign in to TODO when asked and press Allow access.
Ask: "Using TODO, what's on today?"

Get your TODO connection URL

Example Prompts

"What's on today, and what rolled over from yesterday?"
"Add 'renew car insurance' to Friday with a note to compare three quotes."
"Put a weekly task on next week to review finances and split it into three subtasks."
"Find my task about the landlord email, read the notes and draft it."
"Mark the first three tasks on my Shopping list as done."
In Claude Code or Codex: "Read my TODO tasks for today and do the ones that are code. Log what you did."

Frequently Asked Questions

Does TODO have an MCP server?

Yes. TODO has a built-in remote MCP server with 24 tools for reading, adding, editing, completing and deleting tasks across the daily pad, weekly pad and lists.

Which assistants can connect to TODO?

Any MCP client that supports remote servers with OAuth, including Claude, ChatGPT (on plans with developer mode), Claude Code, Codex and Cursor.

Do I need an API key?

No. You approve access once on TODO's sign-in screen, and you can see connected assistants on the MCP page.

Can the assistant read my task notes and attachments?

Yes. get_task_detail returns notes, subtasks and a link to open each attachment, and small text files are included as text.

Is the TODO MCP server free?

Yes. It is included with every TODO account at no cost.