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
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.
Until now.
Open Sunsama is the first task manager built for the AI era:
Traditional productivity apps are closed systems. Your AI can't:
Open Sunsama opens the black box.
Connect your AI assistant in seconds:
// Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"open-sunsama": {
"command": "npx",
"args": ["-y", "@open-sunsama/mcp"],
"env": {
"OPENSUNSAMA_API_KEY": "os_your_api_key_here"
}
}
}
}
24 Tools Available:
| Category | Tools |
|---|---|
| Tasks | list_tasks, create_task, update_task, complete_task, delete_task, schedule_task, reorder_tasks |
| Time Blocks | list_time_blocks, create_time_block, update_time_block, delete_time_block, link_task_to_time_block, get_schedule_for_day |
| Subtasks | list_subtasks, create_subtask, toggle_subtask, update_subtask, delete_subtask |
| User | get_user_profile, update_user_profile |
Once connected, try these with Claude:
"Schedule my top 3 tasks for tomorrow with 2-hour focus blocks"
"What's on my calendar today? Move anything non-urgent to next week"
"Create a task to review the Q4 roadmap, P1 priority, due Friday"
"I finished the design review—mark it complete and start my next task"
For custom integrations:
# Create a task
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-02-03",
"estimatedMins": 120
}'
# Get today's schedule
curl https://api.opensunsama.com/time-blocks?date=2026-02-03 \
-H "X-API-Key: os_your_key"
Scopes: tasks:read, tasks:write, time-blocks:read, time-blocks:write, user:read, user:write
The fastest way to get started:
Prerequisites
# Clone the repository
git clone https://github.com/ShadowWalker2014/open-sunsama.git
cd open-sunsama
# Install dependencies
bun install
# Step 1 - Configure root .env (shared config)
cp .env.example .env
# Step 2 - Configure API .env (api specific config)
cp apps/api/.env.example apps/api/.env
# Generate required secrets
# Run these commands and paste output into both .env files:
# JWT_SECRET → openssl rand -base64 32
# CALENDAR_ENCRYPTION_KEY → openssl rand -hex 32
# For Google Calendar integration
# Follow the setup guide: docs/google-calendar-setup.md
# Run database migrations
bun run db:push
# Start development servers
bun run dev
| Service | URL |
|---|---|
| Web App | http://localhost:3000 |
| API | http://localhost:3001 |
| Drizzle Studio | http://localhost:4983 |
# Start all services
docker-compose up -d
# Or build and run individually
docker build -f Dockerfile.api -t open-sunsama-api .
docker build -f Dockerfile.web -t open-sunsama-web .
Download from opensunsama.com/download or build from source:
cd apps/desktop
bun run tauri build
React 19
TypeScript
Tailwind
PostgreSQL
Bun
Tauri
| Layer | Technologies |
|---|---|
| Frontend | React 19, Vite 6, TanStack Router, TanStack Query, Tailwind CSS, Radix UI, Framer Motion |
| Backend | Hono 4, Drizzle ORM, PostgreSQL 15, PG Boss (jobs), Zod |
| Desktop | Tauri 2 (Rust), system tray, global hotkeys, auto-launch |
| Mobile | Expo 52, React Native, Expo Router |
| Editor | Tiptap (ProseMirror), syntax highlighting, file embeds |
| Infra | Turborepo, Bun workspaces, Docker, Railway |
open-sunsama/
├── apps/
│ ├── api/ # Hono REST API (port 3001)
│ ├── web/ # React + Vite SPA (port 3000)
│ ├── desktop/ # Tauri v2 desktop wrapper
│ └── mobile/ # Expo React Native app
├── packages/
│ ├── database/ # Drizzle ORM, migrations, schema
│ ├── types/ # Shared TypeScript interfaces
│ ├── api-client/ # Type-safe HTTP client + React Query hooks
│ └── utils/ # Date utils, validation, errors
├── mcp/ # MCP server for AI assistants
└── docs/ # Documentation and images
We ship fast. Here's what's coming:
We love contributions! Open Sunsama is built by the community, for the community.
# Fork and clone
git clone https://github.com/YOUR_USERNAME/open-sunsama.git
cd open-sunsama
# Install dependencies
bun install
# Create a branch
git checkout -b feature/amazing-feature
# Make changes and test
bun run dev
bun run typecheck
bun run lint
# Commit with conventional commits
git commit -m "feat: add amazing feature"
# Push and open a PR
git push origin feature/amazing-feature
See CONTRIBUTING.md for detailed guidelines.
Open Sunsama is free for non-commercial use under a custom license.
Permitted:
Requires enterprise license:
See LICENSE for full details.
Built with love using these amazing open-source projects:
Hono Drizzle TanStack Radix UI Tiptap Tauri Expo
If Open Sunsama helps you ship faster, consider giving it a ⭐
Made with ❤️ by Circo
The future of productivity is open.
Install via CLI
npx mdskills install ShadowWalker2014/open-sunsamaOpen Sunsama is a free, open-source AI agent skill. 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
Install Open Sunsama with a single command:
npx mdskills install ShadowWalker2014/open-sunsamaThis downloads the skill files into your project and your AI agent picks them up automatically.
Open Sunsama works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.