Open Sunsama

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)

1. Settings → Customize → Connectors → Add
2. Name it Open Sunsama and paste the URL
3. Continue → Add → Connect, then Allow access

Claude setup guide →

ChatGPT (paid plans, developer mode)

1. Settings → Security and login → Developer mode
2. chatgpt.com/plugins → + → paste the URL
3. 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."

• 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