Your AI assistant can finally manage your calendar. Live Demo · Documentation · API Reference · MCP Setup · Download You use AI assistants daily—Claude, ChatGPT, Copilot. They help you code, write, and think. But when it comes to managing your time? They're useless. Your calendar and task manager are black boxes that AI can't touch. Open Sunsama is the first task manager built for the AI era: - MC
Add this skill
npx mdskills install ShadowWalker2014/open-sunsama@ShadowWalker2014? Sign in with GitHub to claim this listing.Well-documented MCP server with 24 task management tools but lacks clear setup instructions
1<div align="center">23<img src="docs/images/logo.png" alt="Open Sunsama Logo" width="120" height="120" />45# Open Sunsama67### The First AI-Native, Open-Source Task Manager89**Your AI assistant can finally manage your calendar.**1011[](https://github.com/ShadowWalker2014/open-sunsama/stargazers)12[](LICENSE)1314<br />1516[](https://www.typescriptlang.org/)17[](https://react.dev/)18[](https://bun.sh/)19[](https://www.postgresql.org/)20[](https://hono.dev/)21[](https://tauri.app/)2223<br />2425[**Live Demo**](https://opensunsama.com) · [**Documentation**](https://opensunsama.com/docs) · [**API Reference**](https://api.opensunsama.com) · [**MCP Setup**](./mcp/README.md) · [**Download**](https://opensunsama.com/download)2627<br />2829</div>3031---3233## The Problem3435You use AI assistants daily—Claude, ChatGPT, Copilot. They help you code, write, and think.3637But when it comes to **managing your time**? They're useless. Your calendar and task manager are black boxes that AI can't touch.3839**Until now.**4041## The Solution4243Open Sunsama is the **first task manager built for the AI era**:4445- **MCP Protocol Support** — Claude Desktop, Cursor, and Windsurf can manage your tasks directly46- **Full REST API** — Build automations, integrations, and AI workflows47- **100% Open Source** — Self-host, customize, extend, contribute48- **Beautiful UX** — We didn't sacrifice design for openness4950<br />5152---5354## Features5556<table>57<tr>58<td width="50%">5960### Task Management6162- Priorities (P0-P3) with color coding63- Subtasks with progress tracking64- Rich text notes with Tiptap editor65- File attachments (images, videos, docs)66- Drag-and-drop reordering67- Task rollover at midnight6869</td>70<td width="50%">7172### Time Blocking7374- Visual daily/weekly calendar75- Drag to create time blocks76- Resize blocks with snap-to-grid77- Link blocks to tasks78- Track actual vs. estimated time79- Focus mode with timer8081</td>82</tr>83<tr>84<td width="50%">8586### AI & Automation8788- **24 MCP tools** for Claude/Cursor89- RESTful API with scoped API keys90- Background job processing (PG Boss)9192</td>93<td width="50%">9495### Multi-Platform9697- Web app (React + Vite)98- Desktop apps (macOS, Windows, Linux)99- Mobile apps (iOS, Android)100- Dark/light/system themes101102</td>103</tr>104</table>105106---107108## AI Integration109110### Why AI-Native?111112Traditional productivity apps are **closed systems**. Your AI can't:113114- See your calendar to suggest meeting times115- Reschedule tasks when priorities change116- Create time blocks for deep work117- Track your progress across projects118119Open Sunsama **opens the black box**.120121### MCP Server (Model Context Protocol)122123Connect your AI assistant in seconds:124125```json126// Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json127{128 "mcpServers": {129 "open-sunsama": {130 "command": "npx",131 "args": ["-y", "@open-sunsama/mcp"],132 "env": {133 "OPENSUNSAMA_API_KEY": "os_your_api_key_here"134 }135 }136 }137}138```139140**24 Tools Available:**141142| Category | Tools |143| --------------- | ------------------------------------------------------------------------------------------------------------------------------------ |144| **Tasks** | `list_tasks`, `create_task`, `update_task`, `complete_task`, `delete_task`, `schedule_task`, `reorder_tasks` |145| **Time Blocks** | `list_time_blocks`, `create_time_block`, `update_time_block`, `delete_time_block`, `link_task_to_time_block`, `get_schedule_for_day` |146| **Subtasks** | `list_subtasks`, `create_subtask`, `toggle_subtask`, `update_subtask`, `delete_subtask` |147| **User** | `get_user_profile`, `update_user_profile` |148149### Example Prompts150151Once connected, try these with Claude:152153> "Schedule my top 3 tasks for tomorrow with 2-hour focus blocks"154155> "What's on my calendar today? Move anything non-urgent to next week"156157> "Create a task to review the Q4 roadmap, P1 priority, due Friday"158159> "I finished the design review—mark it complete and start my next task"160161### REST API162163For custom integrations:164165```bash166# Create a task167curl -X POST https://api.opensunsama.com/tasks \168 -H "X-API-Key: os_your_key" \169 -H "Content-Type: application/json" \170 -d '{171 "title": "Ship v2.0",172 "priority": "P0",173 "scheduledDate": "2026-02-03",174 "estimatedMins": 120175 }'176177# Get today's schedule178curl https://api.opensunsama.com/time-blocks?date=2026-02-03 \179 -H "X-API-Key: os_your_key"180```181182**Scopes:** `tasks:read`, `tasks:write`, `time-blocks:read`, `time-blocks:write`, `user:read`, `user:write`183184---185186## Quick Start187188### Cloud (Recommended)189190The fastest way to get started:1911921. **Sign up** at [opensunsama.com](https://opensunsama.com)1932. **Generate an API key** in Settings → API Keys1943. **Connect your AI** using the MCP config above195196### Self-Hosted197198<details>199<summary><strong>Prerequisites</strong></summary>200201- [Bun](https://bun.sh/) v1.0+ (or Node.js 20+)202- PostgreSQL 15+203- S3-compatible storage (optional, for file uploads)204205</details>206207```bash208# Clone the repository209git clone https://github.com/ShadowWalker2014/open-sunsama.git210cd open-sunsama211212# Install dependencies213bun install214215# Step 1 - Configure root .env (shared config)216cp .env.example .env217218# Step 2 - Configure API .env (api specific config)219cp apps/api/.env.example apps/api/.env220221# Generate required secrets222# Run these commands and paste output into both .env files:223# JWT_SECRET → openssl rand -base64 32224# CALENDAR_ENCRYPTION_KEY → openssl rand -hex 32225226# For Google Calendar integration227# Follow the setup guide: docs/google-calendar-setup.md228229# Run database migrations230bun run db:push231232# Start development servers233bun run dev234```235236| Service | URL |237| -------------- | --------------------- |238| Web App | http://localhost:3000 |239| API | http://localhost:3001 |240| Drizzle Studio | http://localhost:4983 |241242### Docker243244```bash245# Start all services246docker-compose up -d247248# Or build and run individually249docker build -f Dockerfile.api -t open-sunsama-api .250docker build -f Dockerfile.web -t open-sunsama-web .251```252253### Desktop Apps254255Download from [opensunsama.com/download](https://opensunsama.com/download) or build from source:256257```bash258cd apps/desktop259bun run tauri build260```261262---263264## Tech Stack265266<table>267<tr>268<td align="center" width="96">269 <img src="https://skillicons.dev/icons?i=react" width="48" height="48" alt="React" />270 <br>React 19271</td>272<td align="center" width="96">273 <img src="https://skillicons.dev/icons?i=typescript" width="48" height="48" alt="TypeScript" />274 <br>TypeScript275</td>276<td align="center" width="96">277 <img src="https://skillicons.dev/icons?i=tailwind" width="48" height="48" alt="Tailwind" />278 <br>Tailwind279</td>280<td align="center" width="96">281 <img src="https://skillicons.dev/icons?i=postgresql" width="48" height="48" alt="PostgreSQL" />282 <br>PostgreSQL283</td>284<td align="center" width="96">285 <img src="https://skillicons.dev/icons?i=bun" width="48" height="48" alt="Bun" />286 <br>Bun287</td>288<td align="center" width="96">289 <img src="https://skillicons.dev/icons?i=tauri" width="48" height="48" alt="Tauri" />290 <br>Tauri291</td>292</tr>293</table>294295| Layer | Technologies |296| ------------ | ---------------------------------------------------------------------------------------- |297| **Frontend** | React 19, Vite 6, TanStack Router, TanStack Query, Tailwind CSS, Radix UI, Framer Motion |298| **Backend** | Hono 4, Drizzle ORM, PostgreSQL 15, PG Boss (jobs), Zod |299| **Desktop** | Tauri 2 (Rust), system tray, global hotkeys, auto-launch |300| **Mobile** | Expo 52, React Native, Expo Router |301| **Editor** | Tiptap (ProseMirror), syntax highlighting, file embeds |302| **Infra** | Turborepo, Bun workspaces, Docker, Railway |303304---305306## Architecture307308```309open-sunsama/310├── apps/311│ ├── api/ # Hono REST API (port 3001)312│ ├── web/ # React + Vite SPA (port 3000)313│ ├── desktop/ # Tauri v2 desktop wrapper314│ └── mobile/ # Expo React Native app315├── packages/316│ ├── database/ # Drizzle ORM, migrations, schema317│ ├── types/ # Shared TypeScript interfaces318│ ├── api-client/ # Type-safe HTTP client + React Query hooks319│ └── utils/ # Date utils, validation, errors320├── mcp/ # MCP server for AI assistants321└── docs/ # Documentation and images322```323324---325326## Roadmap327328We ship fast. Here's what's coming:329330- [x] Core task management with priorities331- [x] Time blocking calendar332- [x] MCP server for AI agents (24 tools)333- [x] Desktop apps (macOS, Windows, Linux)334- [x] Mobile apps (iOS, Android)335- [x] Rich text notes with file attachments336- [x] API key authentication with scopes337- [ ] **Calendar sync** (Google Calendar, Outlook) — Q1 2026338- [ ] **Recurring tasks** — Q1 2026339- [ ] **Team workspaces** — Q2 2026340- [ ] **Integrations** (Linear, GitHub, Jira, Notion) — Q2 2026341- [ ] **Analytics dashboard** — Q2 2026342- [ ] **AI auto-scheduling** — Q3 2026343344---345346## Contributing347348We love contributions! Open Sunsama is built by the community, for the community.349350### Ways to Contribute351352- **Report bugs** — Found an issue? [Open a bug report](https://github.com/ShadowWalker2014/open-sunsama/issues/new?template=bug_report.md)353- **Request features** — Have an idea? [Start a discussion](https://github.com/ShadowWalker2014/open-sunsama/discussions/new?category=ideas)354- **Submit PRs** — Code contributions are always welcome355- **Improve docs** — Help others get started356- **Share** — Star the repo and spread the word!357358### Development Setup359360```bash361# Fork and clone362git clone https://github.com/YOUR_USERNAME/open-sunsama.git363cd open-sunsama364365# Install dependencies366bun install367368# Create a branch369git checkout -b feature/amazing-feature370371# Make changes and test372bun run dev373bun run typecheck374bun run lint375376# Commit with conventional commits377git commit -m "feat: add amazing feature"378379# Push and open a PR380git push origin feature/amazing-feature381```382383See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.384385---386387## Community388389<div align="center">390391[](https://github.com/ShadowWalker2014/open-sunsama/discussions)392393</div>394395---396397## License398399Open Sunsama is **free for non-commercial use** under a custom license.400401**Permitted:**402403- Personal use404- Educational use405- Non-profit organizations406- Open source projects407- Evaluation and testing408409**Requires enterprise license:**410411- Commercial use412- Use in products sold for profit413- Production use by for-profit companies414415See [LICENSE](LICENSE) for full details.416417---418419## Acknowledgments420421Built with love using these amazing open-source projects:422423<table>424<tr>425<td align="center"><a href="https://hono.dev/"><img src="https://hono.dev/images/logo.png" width="40" /><br /><sub>Hono</sub></a></td>426<td align="center"><a href="https://orm.drizzle.team/"><img src="https://orm.drizzle.team/favicon.ico" width="40" /><br /><sub>Drizzle</sub></a></td>427<td align="center"><a href="https://tanstack.com/"><img src="https://tanstack.com/favicon.ico" width="40" /><br /><sub>TanStack</sub></a></td>428<td align="center"><a href="https://www.radix-ui.com/"><img src="https://www.radix-ui.com/favicon.ico" width="40" /><br /><sub>Radix UI</sub></a></td>429<td align="center"><a href="https://tiptap.dev/"><img src="https://tiptap.dev/favicon.ico" width="40" /><br /><sub>Tiptap</sub></a></td>430<td align="center"><a href="https://tauri.app/"><img src="https://tauri.app/favicon.ico" width="40" /><br /><sub>Tauri</sub></a></td>431<td align="center"><a href="https://expo.dev/"><img src="https://expo.dev/favicon.ico" width="40" /><br /><sub>Expo</sub></a></td>432</tr>433</table>434435---436437<div align="center">438439<br />440441**If Open Sunsama helps you ship faster, consider giving it a ⭐**442443<br />444445<a href="https://github.com/ShadowWalker2014/open-sunsama/stargazers">446 <img src="https://img.shields.io/github/stars/ShadowWalker2014/open-sunsama?style=for-the-badge&logo=github&color=yellow" alt="Stars" />447</a>448449<br />450<br />451452Made with ❤️ by [Circo](https://circo.so)453454<sub>The future of productivity is open.</sub>455456</div>457
Full transparency — inspect the skill content before installing.