Bluma Sign in

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

The server is hosted. There is nothing to install or keep running.
  1. Sign in at app.bluma.sh and open Settings.
  2. 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.
  3. 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.

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

What an agent adds shows up in every app within seconds.

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.