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
ChatGPT (paid plans, developer mode)
- Settings → Security and login → Developer mode
- chatgpt.com/plugins → + → paste the URL
- Create, then Allow access
Coding assistants connect the same way:
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."
- Standard OAuth 2.1 with PKCE. Claude and ChatGPT are identified by their published client metadata (CIMD), so the consent screen shows a verified badge. Other clients register with dynamic client registration.
- Scoped, short-lived tokens. Access tokens expire hourly and refresh automatically. Refresh tokens rotate, and replaying an old one revokes the whole grant.
- Least privilege. Connector tokens only reach tasks, time blocks, and your profile. They can't touch API keys, passwords, uploads, or calendar accounts.
- Annotated tools. Every tool is marked read-only or destructive, so assistants ask before deleting anything.
- One-click disconnect under Settings → MCP → Connected apps.
{
"mcpServers": {
"open-sunsama": {
"command": "npx",
"args": ["-y", "@open-sunsama/mcp"],
"env": { "OPENSUNSAMA_API_KEY": "os_your_api_key_here" }
}
}
}
You can also send a key to the hosted server as an X-API-Key header. See Local server & API keys.
🎬 See it in action
🧭 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/ShadowWalker2014/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.
Prerequisites: Bun 1.4.2 (run mise install when using mise) and PostgreSQL 15+ (Homebrew's postgresql@17, or a hosted database such as Neon or Supabase). S3-compatible storage is optional, for file uploads.
git clone https://github.com/ShadowWalker2014/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
To run with integrations turned on, copy apps/api/.env.example to apps/api/.env, fill it in, and use bun run dev.
For calendar sync, follow the Google Calendar setup guide.
scripts/readme-media/seed-demo.ts fills an account with a realistic week (tasks, subtasks, time blocks, and ideas) through the REST API. It's the same data behind these screenshots:
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.
If Open Sunsama helps you plan better days, please give it a ⭐. It helps others find it.
Made by Circo · opensunsama.com
