Open Sunsama

Daily planning, done right.

The open-source daily planner for time-blocking, focused work, and seamless AI integration.
AI native: control it from any agent, including Claude, ChatGPT, Cursor, Claude Code, or any MCP client, with one URL and no API key.

Website · Docs · Connect your AI · Self-host · Download apps

_{A real Thursday for a Head of Product: a prioritized board, subtasks, estimates, and a time-blocked schedule. The backlog waits one click away in the right rail.}

✨ Why Open Sunsama

Most planners are closed boxes that your AI assistant can't see into. Open Sunsama is built to be driven by AI as much as by you:

• 🤖 Your AI plans with you. Claude and ChatGPT can read your schedule, create and prioritize tasks, time-block your day, and close things out through a secure one-click connector.
• 🗓️ Sunsama-style daily planning. A kanban board of days, drag-and-drop time blocking, focus mode with a timer, and rollover of unfinished work.
• 🔓 Open source and self-hostable. Run it on your own server, read every line, and extend it through a full REST API.
• 🖥️ Everywhere you work. Web, desktop (macOS, Windows, Linux), and mobile, with light and dark themes and keyboard-first navigation.

🔌 Connect Claude or ChatGPT in 30 seconds

Paste one URL into your AI assistant, sign in, and click Allow access. That's it: no API keys and no config files.

https://api.opensunsama.com/mcp

Claude (web, Desktop, and mobile) Settings → Customize → Connectors → Add Name it Open Sunsama and paste the URL Continue → Add → Connect, then Allow access Claude setup guide →	ChatGPT (paid plans, developer mode) Settings → Security and login → Developer mode chatgpt.com/plugins → + → paste the URL Create, then Allow access ChatGPT setup guide →

Coding assistants connect the same way:

Client	Install
Claude Code	claude mcp add --transport http open-sunsama https://api.opensunsama.com/mcp, then run /mcp → Authenticate
Cursor
VS Code
Any MCP client	Add the URL as a Streamable HTTP server with OAuth

Then just ask:

"What's on my plate today? Move anything that isn't a P0 or P1 to tomorrow."
"Block 9–11am tomorrow for deep work on the launch plan and link it to that task."
"Add subtasks to 'Board deck': metrics slide, roadmap slide, asks."

{
  "mcpServers": {
    "open-sunsama": {
      "command": "npx",
      "args": ["-y", "@open-sunsama/mcp"],
      "env": { "OPENSUNSAMA_API_KEY": "os_your_api_key_here" }
    }
  }
}

🎬 See it in action

_{▶ Watch the full-quality video (MP4) · ▶ Watch the narrated 1-minute tour}

🧭 Everything you need to plan a focused day

Time-block your week Drag tasks onto the calendar and see your whole week at a glance. Blocks link back to their tasks, so estimates meet reality.	Dig into any task Subtasks, rich-text notes, attachments, priority, estimate, and a timer, all in one keyboard-friendly modal.
Focus mode One task, one timer. Track actual time against your estimate while everything else fades away.	⌘K for everything Jump to any task, idea, or setting in a keystroke. Search spans tasks, ideas, and events.
Every task, one list Filter active, completed, or everything, grouped by day with subtask progress.	Ideas: your someday boards Trello-style boards for bets and side projects. Promote an idea to a real task when it's time.

Works on every screen Web app at opensunsama.com Desktop for macOS, Windows, and Linux, with a system tray, a global quick-add hotkey, and notifications (download) Mobile for iOS and Android Calendar sync with Google Calendar, Outlook, and iCloud Recurring routines, task rollover, reminders, and push notifications Keyboard-first: press ? anywhere for shortcuts Themes: light, dark, or system, with multiple color palettes and fonts

🆚 How it compares

Switching from another tool? Read the comparisons: Sunsama · Motion · Akiflow · Reclaim · Todoist

👥 Built for people who plan their day

• Founders and managers juggling roadmaps, 1:1s, hiring, and customer calls, who want one place to decide what matters today.
• Engineers who live in Cursor, Claude Code, and the terminal and want their planner reachable from there.
• Remote and async teams time-blocking across time zones.
• ADHD and neurodivergent planners who need structure, visual time, and gentle rollover instead of guilt.
• Privacy-minded teams who want to self-host their planner and keep data on their own servers.

🛠️ MCP tools

24 tools, available through the hosted connector and the local server:

🧩 REST API

Everything in the app is available over HTTP, with JWT or scoped API keys:

curl -X POST https://api.opensunsama.com/tasks \
  -H "X-API-Key: os_your_key" -H "Content-Type: application/json" \
  -d '{"title": "Ship v2.0", "priority": "P0", "scheduledDate": "2026-10-01", "estimatedMins": 120}'

Scopes: tasks:read tasks:write time-blocks:read time-blocks:write ideas:read ideas:write user:read user:write. See the API reference.

🚀 Get started

Cloud: create an account at opensunsama.com, then connect your AI.

Self-host with Docker:

git clone https://github.com/kaijiabo/open-sunsama.git
cd open-sunsama
docker compose up -d --build   # PostgreSQL, Redis, API on :3001, web app on :3000

Open http://localhost:3000 and create your account. The API creates the database tables on start, and the MCP connector is at http://localhost:3001/mcp. The self-hosting guide covers running on a server with your own domain, optional integrations, and backups. The desktop and mobile apps connect only to opensunsama.com, so self-hosters use the web app.

git clone https://github.com/kaijiabo/open-sunsama.git
cd open-sunsama
mise install
bun install

# API on :3001 and web app on :3000. Tables are created on start;
# Redis, email, background jobs and OAuth stay off.
DEV_DATABASE_URL=postgresql://localhost:5432/opensunsama bun run dev:local

DEMO_API_URL=http://localhost:3001 DEMO_PASSWORD='Choose-a-strong-1' bun run scripts/readme-media/seed-demo.ts

🏗️ Tech stack

open-sunsama/
├── apps/
│   ├── api/        # Hono REST API, OAuth server, and the /mcp endpoint
│   ├── web/        # React + Vite app, docs, and marketing site
│   ├── desktop/    # Tauri v2 desktop app
│   └── mobile/     # Mobile apps
├── packages/       # database (Drizzle), types, api-client, utils
└── mcp/            # MCP tools + the npx stdio server

🗺️ Roadmap

• Daily planning board, priorities, subtasks, and rich notes
• Time-blocking calendar with day, 3-day, week, and month views
• Focus mode, routines (recurring tasks), and rollover
• Calendar sync: Google Calendar, Outlook, and iCloud
• Ideas boards and a ⌘K command palette
• Desktop and mobile apps
• MCP server (local stdio) and REST API with scoped keys
• One-click Claude & ChatGPT connector (hosted MCP + OAuth)
• Team workspaces
• Integrations (Linear, GitHub, Jira, Notion)
• Analytics dashboard
• AI auto-scheduling

Have an idea? Open a feature request. Found a bug? Report it.

❓ FAQ

🤝 Contributing

Contributions are welcome! Open an issue, ask in Discussions, or send a PR. See CONTRIBUTING.md.

git checkout -b feature/amazing-feature
bun run dev && bun run typecheck && bun run lint
git commit -m "feat: add amazing feature"

📄 License

Open Sunsama uses a custom non-commercial license. It covers personal, educational, non-profit, and open-source use, plus evaluation. Commercial use by for-profit companies requires an enterprise license. See LICENSE.