# Bluma > A task manager for people and their agents. Mac, iPhone and web apps, with an MCP server, a CLI and a REST API over the same lists. Sign up at https://app.bluma.sh, or from the terminal with `bluma signup --email you@example.com`. Then create an API token for each agent with `bluma token add `. ## Lists - Inbox: captured, not yet sorted - Today: scheduled for today or earlier, or due - Upcoming: scheduled for a future date - Anytime: ready to do, no date - Someday: parked - Logbook: completed or canceled Tasks have notes, tags, a checklist, a start date and a deadline. They can sit in a project (optionally under a heading) or in an area. ## Reminders, This Evening and repeats A task can carry three extras, on every surface (apps, CLI, MCP, REST): - `remindAt`: a reminder in the person's local time, written "2026-12-01T09:00" with no time zone. null clears it. - `evening`: true files the task under This Evening when it is in Today. - `repeat`: { "every": 2, "unit": "week", "after": "schedule" }. Units are day, week, month and year. "schedule" counts from the date the task was due, "completion" from the day it was finished. Completing the task creates the next one on its next date, with the same notes, tags and checklist. null ends the repeat. ## Import - `bluma import things` brings open areas, projects, headings and to-dos over from Things 3 on a Mac. It reads a copy of the database and never changes Things. - `bluma import todoist ` takes Todoist's CSV exports, one project per file. - Both accept `--dry-run`, skip finished and trashed items, and skip what an earlier import already made. ## For agents - MCP (Streamable HTTP): https://api.bluma.sh/mcp with the header `Authorization: Bearer blm_…` - Tools: overview, list_tasks, get_task, add_tasks, update_tasks, complete_tasks, trash_tasks, list_projects, add_project, update_project, add_area - Batch tools report per-item failures without dropping the rest of the batch. - Dates accept "today", "tomorrow" or YYYY-MM-DD. - add_tasks and update_tasks accept "remindAt", "evening" and "repeat" as described above. ## REST API Base: https://api.bluma.sh/v1 with `Authorization: Bearer blm_…` - POST /signup and POST /login take { email, password } and return { user, token }. No bearer token needed. - GET /tasks?view=today (also inbox, upcoming, anytime, someday, logbook, trash; filters projectId, areaId, tag, q, limit) - POST /tasks, PATCH /tasks/:id, DELETE /tasks/:id, POST /tasks/:id/restore - /projects, /areas, /headings: same shape - GET /sync?since=: everything changed since a revision - Errors: { "error": { "code", "message", "issues" } } ## Links - Web app: https://app.bluma.sh - Mac app: https://dl.bluma.sh/Bluma.dmg (macOS 15 or later)