Guide
A to-do app built for AI agents
TodoCity is a Mac to-do app made for the age of AI assistants. Its built-in MCP server lets Claude Code, Claude Desktop, Cursor, VS Code, Windsurf and LM Studio add tasks for you, each waiting for your OK. Turn on Full access and they can run your list for you: read, add, change, schedule to the minute, complete and delete tasks, sub-tasks, reminders, projects and sections, with 28 tools. It can also run Claude Code in the background, on a schedule, to pull the to-dos out of your new email. And TodoCity's own AI runs on your Mac.
- MCP server
- Built in: add_task, or 28 tools with full access
- AI apps
- Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, LM Studio
- Access
- Add-only (you approve each task) or full access: your choice
- Where it works
- On this Mac only, over a private local connection
Three kinds of AI, each with one job
- On-device AI reads what you capture (⌘C twice) and writes the task with its date and repeat, offline and never sent to a cloud AI.
- The AI apps you already use add tasks over MCP: tell Claude “add a TodoCity task to send the deck Friday 3pm”.
- A background agent checks your new email on a schedule and sends you the to-dos it finds, for review.
Connect an AI app
- Open Connectors. In TodoCity, open Settings → Connectors → AI agents and turn on “Let AI agents on this Mac add tasks”.
- Pick your app. Click Connect next to Claude Code, Claude Desktop, Cursor, VS Code, Windsurf or LM Studio. TodoCity adds itself to that app's MCP settings and backs up the original first.
- Ask for a task. In the AI app, say “add a TodoCity task to call the bank tomorrow at 10”.
- Approve it. The task waits in the menu-bar dropdown. Add puts it on your list; Dismiss drops it.
Prefer agents to notice deadlines on their own? Turn on “Let agents suggest tasks on their own”: when you mention a deadline or say “remind me”, they send it to TodoCity without being asked. You still approve each one.
Add-only, or full access: you choose
Out of the box, agents get one tool, add_task, and the same reply for every task (no ids, no counts, no duplicate check), so an agent learns nothing about your list. At most 20 tasks arrive every 10 minutes, and 50 can wait for review.
Turn on Full access (Settings → Agents) and agents get 28 tools to run your list on their own: read and search tasks, add and change them, schedule them to the minute with a length, snooze reminders, tick off sub-tasks, complete, delete, and manage projects and sections. Changes apply right away. What an agent reads, it may send to its AI service, as with anything you share with it.
Either way, TodoCity talks to agents over a private connection that only your Mac user account can open, so agents in the cloud can't reach it on their own.
Tasks from what's on your screen
Turn on Watch and TodoCity suggests tasks from the app in front of you: requests in Mail, Outlook or Slack, deadlines, and things you promised. You pick who reads the new text: the open model on your Mac, or an agent you've connected, like Claude Code or Codex. Every suggestion waits for your OK.
Watch is off until you turn it on. When an agent reads for it, the new text goes to that agent and its AI service, signed in as you. Password managers, Keychain and terminals are never read.
How it compares
| Feature | TodoCity | Things 3 | Todoist | Apple Reminders |
|---|---|---|---|---|
| MCP server for AI apps | Built in, on your Mac | No official one | Official, in the cloud | No official one |
| What agents can do | Add tasks only, approved by you | Nothing | Read and change your tasks | Nothing |
| Tasks from your screen | Watch, with an agent or on-device model | No | No | No |
| AI on your device | Yes, any Mac with macOS 11+ | No | No (cloud) | Apple Intelligence on supported Macs |
Questions
Which AI apps can add tasks to TodoCity?
Claude Code, Claude Desktop, Cursor, VS Code, Windsurf and LM Studio connect in one click from Settings → Connectors → AI agents. Any other app that supports local (stdio) MCP servers can run TodoCity --mcp.
Can an AI agent see my tasks?
Only if you turn on Full access. By default TodoCity's MCP server is add-only: agents can add a task, every task gets the same reply, and they can't read, change, delete or count your tasks. With Full access on, connected agents can read and change your list.
Does the background agent send my email anywhere?
TodoCity never reads your email. Claude Code reads it through the mail connection you set up in Claude Code, under your Claude account, the same as if you asked it yourself. TodoCity only receives the tasks it finds.