A task manager your agents can use
Bluma is a to-do app with a hosted MCP server. Connect Claude Code, Cursor, Codex or any MCP client with one command, and it works in the same lists you see on your Mac, your iPhone and the web.
Open in browserDownload for Mac
Connect in one command
$ claude mcp add --transport http bluma \ https://api.bluma.sh/mcp \ --header "Authorization: Bearer blm_…" Added HTTP MCP server bluma > plan my afternoon bluma · overview bluma · add_tasks 3 added to Today
- Sign in at app.bluma.sh and open Settings.
- Under API tokens, name a token after the agent, for example "Claude Code", and copy it. Choose Read only for an agent that only needs to look, and an expiry if it should stop working by itself.
- Run the command Connect an agent shows you. For Claude Code it is:
claude mcp add --transport http bluma https://api.bluma.sh/mcp --header "Authorization: Bearer blm_…"
The server speaks MCP over Streamable HTTP at https://api.bluma.sh/mcp, so it also works with Cursor, Codex and any client that takes a URL and a header. Each agent gets its own token, which you can revoke on its own.
What an agent can do
The server has 19 tools, three prompts and a schema resource. They cover what the apps can do, in batches, so planning a day takes two or three calls.
- Get oriented in one call.
overviewreturns today's date, counts for each list, Today and This Evening, anything overdue, the week ahead, and your projects, areas and tags. - Search with filters.
list_tasksreads any list or searches by text, tag, project, area, status and date range, a page at a time. - Add and change in batches.
add_tasks,update_tasksandcomplete_taskstake many to-dos at once and report each failure without dropping the rest. - Reminders, repeats and This Evening. An agent can set a reminder time, a repeat rule or the evening flag on any to-do.
- Projects, areas, headings and checklists.
add_project,add_headings,edit_checklist,reorder,trashandrestore. - Ready-made prompts.
plan_my_day,weekly_reviewandtriage_inbox.
Emptying the Trash is left to you. An agent can move things to the Trash and bring them back, and that is all.
You see it happen
- Inbox2
- Today4
- Upcoming
- Anytime
- Someday
- Logbook
- Trash
- Send the invoice to Maradue today
- Review the launch copy0/3
- This Evening
- Take out the bins7:30 PMRepeats
- Call mum
Agents write to your real lists, not to a side file in a repository. A to-do Claude Code adds at your desk is on your phone when you leave it, with its reminder. When you tick it off, the agent sees that the next time it looks.
Agents can tell us what is missing
The server has a submit_feedback tool. When an agent hits a missing filter, a confusing description or an error it cannot recover from, it files a short report with a proposed fix, and we read it. The report describes the tool problem and leaves your to-dos out.
Also a CLI and a REST API
The same account works from a script: see Bluma from the terminal. The full reference for agents is in llms.txt, and the step-by-step guide is Agents, the CLI and the API.
Questions
Which AI agents work with Bluma?
Any client that speaks MCP over Streamable HTTP with a bearer token. That includes Claude Code, Cursor and Codex. The web app's Settings shows the exact command for Claude Code and a JSON config for clients that take a file.
Do I have to run the MCP server myself?
No. It is hosted at https://api.bluma.sh/mcp. You create an API token in Settings and give it to the agent.
Can an agent delete my to-dos?
An agent can move to-dos to the Trash and restore them. Emptying the Trash, which deletes for good, can only be done by you in the apps or the CLI.
Is there a cost?
Bluma is free to use today, including the MCP server and the API. There is no paid plan.