Skip to content
Back to search

open-sunsama

Open-source Sunsama alternative: a daily planner with kanban, time blocking, and focus mode that Claude and ChatGPT can use. One-click MCP connector (OAuth), REST API, web/desktop/mobile apps, self-hostable.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/shadowwalker2014--open-sunsama/badge.svg)](/listings/shadowwalker2014--open-sunsama)

HTML

<a href="/listings/shadowwalker2014--open-sunsama"><img src="/api/listings/shadowwalker2014--open-sunsama/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 461 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <a href="https://opensunsama.com"><img src="docs/images/logo.png" alt="Open Sunsama logo" width="96" height="96" /></a>
  3. # Open Sunsama
  4. ### Daily planning, done right.
  5. The open-source daily planner for time-blocking, focused work, and seamless AI integration.<br />
  6. **AI native:** control it from any agent, including **Claude**, **ChatGPT**, Cursor, Claude Code, or any MCP client, with one URL and no API key.
  7. <br />
  8. [![Open the app](https://img.shields.io/badge/Open_the_app-opensunsama.com-F97316?style=for-the-badge)](https://opensunsama.com)
  9. [![Connect Claude](https://img.shields.io/badge/Claude-Add_connector-D97757?style=for-the-badge&logo=claude&logoColor=white)](#-connect-claude-or-chatgpt-in-30-seconds)
  10. [![Connect ChatGPT](https://img.shields.io/badge/ChatGPT-Add_app-10A37F?style=for-the-badge)](#-connect-claude-or-chatgpt-in-30-seconds)
  11. [![GitHub stars](https://img.shields.io/github/stars/kaijiabo/open-sunsama?style=for-the-badge&logo=github&color=yellow)](https://github.com/kaijiabo/open-sunsama/stargazers)
  12. [**Website**](https://opensunsama.com) · [**Docs**](https://opensunsama.com/docs) · [**Connect your AI**](https://opensunsama.com/docs/mcp/overview) · [**Self-host**](#-get-started) · [**Download apps**](https://opensunsama.com/download)
  13. <br />
  14. <picture>
  15. <source media="(prefers-color-scheme: dark)" srcset="docs/images/readme/board-dark.png" />
  16. <img src="docs/images/readme/board.png" alt="Open Sunsama board: today's prioritized tasks in columns by day, with a time-blocked schedule on the right" width="100%" />
  17. </picture>
  18. <sub>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.</sub>
  19. </div>
  20. <br />
  21. ## ✨ Why Open Sunsama
  22. 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:
  23. - **🤖 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.
  24. - **🗓️ Sunsama-style daily planning.** A kanban board of days, drag-and-drop time blocking, focus mode with a timer, and rollover of unfinished work.
  25. - **🔓 Open source and self-hostable.** Run it on your own server, read every line, and extend it through a full REST API.
  26. - **🖥️ Everywhere you work.** Web, desktop (macOS, Windows, Linux), and mobile, with light and dark themes and keyboard-first navigation.
  27. <br />
  28. ## 🔌 Connect Claude or ChatGPT in 30 seconds
  29. Paste one URL into your AI assistant, sign in, and click **Allow access**. That's it: no API keys and no config files.
  30. ```
  31. https://api.opensunsama.com/mcp
  32. ```
  33. <table>
  34. <tr>
  35. <td width="50%" valign="top">
  36. **Claude** (web, Desktop, and mobile)
  37. 1. **Settings → Customize → Connectors → Add**
  38. 2. Name it *Open Sunsama* and paste the URL
  39. 3. **Continue → Add → Connect**, then **Allow access**
  40. [Claude setup guide →](https://opensunsama.com/docs/mcp/claude)
  41. </td>
  42. <td width="50%" valign="top">
  43. **ChatGPT** (paid plans, developer mode)
  44. 1. **Settings → Security and login → Developer mode**
  45. 2. [chatgpt.com/plugins](https://chatgpt.com/plugins) → **+** → paste the URL
  46. 3. **Create**, then **Allow access**
  47. [ChatGPT setup guide →](https://opensunsama.com/docs/mcp/chatgpt)
  48. </td>
  49. </tr>
  50. <tr>
  51. <td width="50%" align="center"><img src="docs/images/readme/consent-claude.png" alt="Open Sunsama consent screen: Claude wants to access your Open Sunsama account, verified app from claude.ai" width="88%" /></td>
  52. <td width="50%" align="center"><img src="docs/images/readme/consent-chatgpt.png" alt="Open Sunsama consent screen: ChatGPT wants to access your Open Sunsama account, verified app from chatgpt.com" width="88%" /></td>
  53. </tr>
  54. </table>
  55. **Coding assistants** connect the same way:
  56. | Client | Install |
  57. | --- | --- |
  58. | **Claude Code** | `claude mcp add --transport http open-sunsama https://api.opensunsama.com/mcp`, then run `/mcp` → Authenticate |
  59. | **Cursor** | [![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=open-sunsama&config=eyJ1cmwiOiJodHRwczovL2FwaS5vcGVuc3Vuc2FtYS5jb20vbWNwIn0=) |
  60. | **VS Code** | [![Add to VS Code](https://img.shields.io/badge/VS_Code-Add_MCP_server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=open-sunsama&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//api.opensunsama.com/mcp%22%7D) |
  61. | **Any MCP client** | Add the URL as a Streamable HTTP server with OAuth |
  62. Then just ask:
  63. > *"What's on my plate today? Move anything that isn't a P0 or P1 to tomorrow."*<br />
  64. > *"Block 9–11am tomorrow for deep work on the launch plan and link it to that task."*<br />
  65. > *"Add subtasks to 'Board deck': metrics slide, roadmap slide, asks."*
  66. <details>
  67. <summary><b>How the connection stays secure</b></summary>
  68. <br />
  69. - **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.
  70. - **Scoped, short-lived tokens.** Access tokens expire hourly and refresh automatically. Refresh tokens rotate, and replaying an old one revokes the whole grant.
  71. - **Least privilege.** Connector tokens only reach tasks, time blocks, and your profile. They can't touch API keys, passwords, uploads, or calendar accounts.
  72. - **Annotated tools.** Every tool is marked read-only or destructive, so assistants ask before deleting anything.
  73. - **One-click disconnect** under **Settings → MCP → Connected apps**.
  74. <p align="center"><img src="docs/images/readme/mcp-settings.png" alt="Settings → MCP: connector URL, step-by-step setup per assistant, and connected apps list showing Claude and ChatGPT" width="70%" /></p>
  75. </details>
  76. <details>
  77. <summary><b>Prefer an API key? The local server still works</b></summary>
  78. <br />
  79. ```json
  80. {
  81. "mcpServers": {
  82. "open-sunsama": {
  83. "command": "npx",
  84. "args": ["-y", "@open-sunsama/mcp"],
  85. "env": { "OPENSUNSAMA_API_KEY": "os_your_api_key_here" }
  86. }
  87. }
  88. }
  89. ```
  90. You can also send a key to the hosted server as an `X-API-Key` header. See [Local server & API keys](https://opensunsama.com/docs/mcp/local-server).
  91. </details>
  92. <br />
  93. ## 🎬 See it in action
  94. <p align="center">
  95. <img src="docs/images/readme/demo.gif" alt="Demo: adding a task, opening task details, switching to the week calendar, tasks list, ideas board, and connecting an AI assistant" width="100%" />
  96. </p>
  97. <p align="center"><sub><a href="docs/images/readme/demo.mp4">▶ Watch the full-quality video (MP4)</a> · <a href="https://opensunsama.com">▶ Watch the narrated 1-minute tour</a></sub></p>
  98. <br />
  99. ## 🧭 Everything you need to plan a focused day
  100. <table>
  101. <tr>
  102. <td width="50%" valign="top">
  103. ### Time-block your week
  104. Drag tasks onto the calendar and see your whole week at a glance. Blocks link back to their tasks, so estimates meet reality.
  105. <img src="docs/images/readme/calendar-week.png" alt="Week calendar full of color-coded time blocks from Monday to Friday" width="100%" />
  106. </td>
  107. <td width="50%" valign="top">
  108. ### Dig into any task
  109. Subtasks, rich-text notes, attachments, priority, estimate, and a timer, all in one keyboard-friendly modal.
  110. <img src="docs/images/readme/task-detail.png" alt="Task detail modal with subtasks, notes, P0 priority, and a running focus timer" width="100%" />
  111. </td>
  112. </tr>
  113. <tr>
  114. <td width="50%" valign="top">
  115. ### Focus mode
  116. One task, one timer. Track actual time against your estimate while everything else fades away.
  117. <img src="docs/images/readme/focus.png" alt="Focus mode with 23 minutes tracked against a 90-minute estimate and a Start button" width="100%" />
  118. </td>
  119. <td width="50%" valign="top">
  120. ### ⌘K for everything
  121. Jump to any task, idea, or setting in a keystroke. Search spans tasks, ideas, and events.
  122. <img src="docs/images/readme/command-palette.png" alt="Command palette searching 'review' across tasks and ideas" width="100%" />
  123. </td>
  124. </tr>
  125. <tr>
  126. <td width="50%" valign="top">
  127. ### Every task, one list
  128. Filter active, completed, or everything, grouped by day with subtask progress.
  129. <img src="docs/images/readme/tasks.png" alt="Tasks list grouped by Today, Tomorrow, and upcoming days with priority dots and subtask counts" width="100%" />
  130. </td>
  131. <td width="50%" valign="top">
  132. ### Ideas: your someday boards
  133. Trello-style boards for bets and side projects. Promote an idea to a real task when it's time.
  134. <img src="docs/images/readme/ideas.png" alt="Ideas board with Someday, Exploring, and Ready to build columns" width="100%" />
  135. </td>
  136. </tr>
  137. </table>
  138. <table>
  139. <tr>
  140. <td width="32%" align="center" valign="top">
  141. <img src="docs/images/readme/mobile-tasks.png" alt="Open Sunsama on a phone: today's tasks with priorities and completed items" width="100%" />
  142. </td>
  143. <td width="68%" valign="top">
  144. ### Works on every screen
  145. - **Web app** at [opensunsama.com](https://opensunsama.com)
  146. - **Desktop** for macOS, Windows, and Linux, with a system tray, a global quick-add hotkey, and notifications ([download](https://opensunsama.com/download))
  147. - **Mobile** for iOS and Android
  148. - **Calendar sync** with Google Calendar, Outlook, and iCloud
  149. - **Recurring routines**, task rollover, reminders, and push notifications
  150. - **Keyboard-first**: press `?` anywhere for shortcuts
  151. - **Themes**: light, dark, or system, with multiple color palettes and fonts
  152. </td>
  153. </tr>
  154. </table>
  155. <br />
  156. ## 🆚 How it compares
  157. | | **Open Sunsama** | Typical closed planners |
  158. | --- | :---: | :---: |
  159. | Open source & self-hostable | ✅ | ❌ |
  160. | AI native: control it from any agent over MCP | ✅ | ❌ |
  161. | One-click Claude & ChatGPT connector (OAuth) | ✅ | Rare |
  162. | Full REST API with scoped keys | ✅ | Limited |
  163. | Daily planning board + time blocking | ✅ | ✅ |
  164. | Focus timer, routines, rollover | ✅ | Varies |
  165. | Web, desktop, and mobile apps | ✅ | ✅ |
  166. Switching from another tool? Read the comparisons: [Sunsama](https://opensunsama.com/alternative/sunsama) · [Motion](https://opensunsama.com/alternative/motion) · [Akiflow](https://opensunsama.com/alternative/akiflow) · [Reclaim](https://opensunsama.com/alternative/reclaim) · [Todoist](https://opensunsama.com/alternative/todoist)
  167. <br />
  168. ## 👥 Built for people who plan their day
  169. - **Founders and managers** juggling roadmaps, 1:1s, hiring, and customer calls, who want one place to decide what matters today.
  170. - **Engineers** who live in [Cursor, Claude Code, and the terminal](https://opensunsama.com/for/developers) and want their planner reachable from there.
  171. - **Remote and async teams** [time-blocking across time zones](https://opensunsama.com/for/remote-workers).
  172. - **ADHD and neurodivergent planners** who need [structure, visual time, and gentle rollover](https://opensunsama.com/for/adhd) instead of guilt.
  173. - **Privacy-minded teams** who want to self-host their planner and keep data on their own servers.
  174. <br />
  175. ## 🛠️ MCP tools
  176. 24 tools, available through the hosted connector and the local server:
  177. | Category | Tools |
  178. | --- | --- |
  179. | **Tasks** | `list_tasks` `get_task` `create_task` `update_task` `complete_task` `uncomplete_task` `delete_task` `schedule_task` `reorder_tasks` |
  180. | **Time blocks** | `list_time_blocks` `get_time_block` `create_time_block` `update_time_block` `delete_time_block` `link_task_to_time_block` `get_schedule_for_day` |
  181. | **Calendar events** (read-only) | `list_calendar_events` |
  182. | **Subtasks** | `list_subtasks` `create_subtask` `toggle_subtask` `update_subtask` `delete_subtask` |
  183. | **Profile** | `get_user_profile` `update_user_profile` |
  184. ## 🧩 REST API
  185. Everything in the app is available over HTTP, with JWT or scoped API keys:
  186. ```bash
  187. curl -X POST https://api.opensunsama.com/tasks \
  188. -H "X-API-Key: os_your_key" -H "Content-Type: application/json" \
  189. -d '{"title": "Ship v2.0", "priority": "P0", "scheduledDate": "2026-10-01", "estimatedMins": 120}'
  190. ```
  191. Scopes: `tasks:read` `tasks:write` `time-blocks:read` `time-blocks:write` `ideas:read` `ideas:write` `user:read` `user:write`. See the [API reference](https://opensunsama.com/docs/api/authentication).
  192. <br />
  193. ## 🚀 Get started
  194. **Cloud:** create an account at [opensunsama.com](https://opensunsama.com), then [connect your AI](#-connect-claude-or-chatgpt-in-30-seconds).
  195. **Self-host with Docker:**
  196. ```bash
  197. git clone https://github.com/kaijiabo/open-sunsama.git
  198. cd open-sunsama
  199. docker compose up -d --build # PostgreSQL, Redis, API on :3001, web app on :3000
  200. ```
  201. 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](https://opensunsama.com/docs/self-hosting/docker) 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.
  202. <details>
  203. <summary><b>Run from source</b></summary>
  204. <br />
  205. Prerequisites: [Bun](https://bun.sh) 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.
  206. ```bash
  207. git clone https://github.com/kaijiabo/open-sunsama.git
  208. cd open-sunsama
  209. mise install
  210. bun install
  211. # API on :3001 and web app on :3000. Tables are created on start;
  212. # Redis, email, background jobs and OAuth stay off.
  213. DEV_DATABASE_URL=postgresql://localhost:5432/opensunsama bun run dev:local
  214. ```
  215. To run with integrations turned on, copy `apps/api/.env.example` to `apps/api/.env`, fill it in, and use `bun run dev`.
  216. | Service | URL |
  217. | --- | --- |
  218. | Web app | http://localhost:3000 |
  219. | API | http://localhost:3001 |
  220. | MCP connector | http://localhost:3001/mcp |
  221. | Drizzle Studio | http://localhost:4983 |
  222. For calendar sync, follow the [Google Calendar setup guide](docs/calendar/google-calendar-setup.md).
  223. </details>
  224. <details>
  225. <summary><b>Seed a demo workspace</b></summary>
  226. <br />
  227. `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:
  228. ```bash
  229. DEMO_API_URL=http://localhost:3001 DEMO_PASSWORD='Choose-a-strong-1' bun run scripts/readme-media/seed-demo.ts
  230. ```
  231. </details>
  232. <br />
  233. ## 🏗️ Tech stack
  234. | Layer | Technologies |
  235. | --- | --- |
  236. | **Frontend** | React 19, Vite, TanStack Router + Query, Tailwind CSS, Radix UI, Tiptap |
  237. | **Backend** | Hono 4, Drizzle ORM, PostgreSQL, PG Boss jobs, Zod, OAuth 2.1 authorization server |
  238. | **AI** | Model Context Protocol (Streamable HTTP + stdio), 24 annotated tools |
  239. | **Desktop / mobile** | Tauri 2, Expo |
  240. | **Infra** | Bun workspaces, Turborepo, Docker, Railway |
  241. ```
  242. open-sunsama/
  243. ├── apps/
  244. │ ├── api/ # Hono REST API, OAuth server, and the /mcp endpoint
  245. │ ├── web/ # React + Vite app, docs, and marketing site
  246. │ ├── desktop/ # Tauri v2 desktop app
  247. │ └── mobile/ # Mobile apps
  248. ├── packages/ # database (Drizzle), types, api-client, utils
  249. └── mcp/ # MCP tools + the npx stdio server
  250. ```
  251. <br />
  252. ## 🗺️ Roadmap
  253. - [x] Daily planning board, priorities, subtasks, and rich notes
  254. - [x] Time-blocking calendar with day, 3-day, week, and month views
  255. - [x] Focus mode, routines (recurring tasks), and rollover
  256. - [x] Calendar sync: Google Calendar, Outlook, and iCloud
  257. - [x] Ideas boards and a ⌘K command palette
  258. - [x] Desktop and mobile apps
  259. - [x] MCP server (local stdio) and REST API with scoped keys
  260. - [x] **One-click Claude & ChatGPT connector** (hosted MCP + OAuth)
  261. - [ ] Team workspaces
  262. - [ ] Integrations (Linear, GitHub, Jira, Notion)
  263. - [ ] Analytics dashboard
  264. - [ ] AI auto-scheduling
  265. Have an idea? [Open a feature request](https://github.com/kaijiabo/open-sunsama/issues/new?template=feature.yml). Found a bug? [Report it](https://github.com/kaijiabo/open-sunsama/issues/new?template=bug.yml).
  266. <br />
  267. ## ❓ FAQ
  268. <details>
  269. <summary><b>What is Open Sunsama?</b></summary>
  270. <br />
  271. An open-source daily planner and task manager inspired by Sunsama. You plan each day on a kanban board, time-block tasks on a calendar, and work through them in focus mode. It's also an MCP server, so AI assistants like Claude and ChatGPT can manage your tasks and schedule for you.
  272. </details>
  273. <details>
  274. <summary><b>Is it an open-source Sunsama alternative?</b></summary>
  275. <br />
  276. Yes. It covers Sunsama's daily-planning loop (a kanban board, time blocking, focus mode, and calendar sync), the code is on GitHub, and you can self-host it. On top of that, any AI agent can run it over MCP. See <a href="#-license">License</a> for the terms.
  277. </details>
  278. <details>
  279. <summary><b>How do I connect it to ChatGPT or Claude?</b></summary>
  280. <br />
  281. Add <code>https://api.opensunsama.com/mcp</code> as a custom connector in Claude, or as a plugin connection in ChatGPT's developer mode. Then sign in and click <b>Allow access</b>. Step-by-step guides: <a href="https://opensunsama.com/docs/mcp/claude">Claude</a> and <a href="https://opensunsama.com/docs/mcp/chatgpt">ChatGPT</a>.
  282. </details>
  283. <details>
  284. <summary><b>What is MCP?</b></summary>
  285. <br />
  286. The <a href="https://modelcontextprotocol.io">Model Context Protocol</a> is an open standard for connecting AI assistants to tools and data. Open Sunsama's MCP server gives assistants 24 tools to read and update your tasks, subtasks, and time blocks.
  287. </details>
  288. <details>
  289. <summary><b>Can my AI delete my tasks without asking?</b></summary>
  290. <br />
  291. Destructive tools are annotated as such, so Claude and ChatGPT ask for confirmation before running them. You can revoke an assistant's access at any time under Settings → MCP.
  292. </details>
  293. <details>
  294. <summary><b>Does it work with Cursor, VS Code, and Claude Code?</b></summary>
  295. <br />
  296. Yes. Use the one-click buttons above for Cursor and VS Code, or run <code>claude mcp add --transport http open-sunsama https://api.opensunsama.com/mcp</code> for Claude Code.
  297. </details>
  298. <br />
  299. ## 🤝 Contributing
  300. Contributions are welcome! [Open an issue](https://github.com/kaijiabo/open-sunsama/issues/new/choose), [ask in Discussions](https://github.com/kaijiabo/open-sunsama/discussions), or send a PR. See [CONTRIBUTING.md](CONTRIBUTING.md).
  301. ```bash
  302. git checkout -b feature/amazing-feature
  303. bun run dev && bun run typecheck && bun run lint
  304. git commit -m "feat: add amazing feature"
  305. ```
  306. ## 📄 License
  307. 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](LICENSE).
  308. <br />
  309. <div align="center">
  310. **If Open Sunsama helps you plan better days, please give it a ⭐. It helps others find it.**
  311. [![Star on GitHub](https://img.shields.io/github/stars/kaijiabo/open-sunsama?style=for-the-badge&logo=github&color=yellow)](https://github.com/kaijiabo/open-sunsama/stargazers)
  312. <a href="https://star-history.com/#kaijiabo/open-sunsama&Date">
  313. <picture>
  314. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=kaijiabo/open-sunsama&type=Date&theme=dark" />
  315. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=kaijiabo/open-sunsama&type=Date" />
  316. <img alt="Star history chart for Open Sunsama" src="https://api.star-history.com/svg?repos=kaijiabo/open-sunsama&type=Date" width="600" />
  317. </picture>
  318. </a>
  319. <sub>Made by <a href="https://circo.so">Circo</a> · <a href="https://opensunsama.com">opensunsama.com</a></sub>
  320. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.