Open Sunsama

The First AI-Native, Open-Source Task Manager

Your AI assistant can finally manage your calendar.

Live Demo · Documentation · API Reference · MCP Setup · Download

The Problem

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.

The Solution

Open Sunsama is the first task manager built for the AI era:

• MCP Protocol Support — Claude Desktop, Cursor, and Windsurf can manage your tasks directly
• Full REST API — Build automations, integrations, and AI workflows
• 100% Open Source — Self-host, customize, extend, contribute
• Beautiful UX — We didn't sacrifice design for openness

Features

AI Integration

Why AI-Native?

Traditional productivity apps are closed systems. Your AI can't:

• See your calendar to suggest meeting times
• Reschedule tasks when priorities change
• Create time blocks for deep work
• Track your progress across projects

Open Sunsama opens the black box.

MCP Server (Model Context Protocol)

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:

Example Prompts

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"

REST API

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

Quick Start

Cloud (Recommended)

The fastest way to get started:

1. Sign up at opensunsama.com
2. Generate an API key in Settings → API Keys
3. Connect your AI using the MCP config above

Self-Hosted

• Bun v1.0+ (or Node.js 20+)
• PostgreSQL 15+
• S3-compatible storage (optional, for file uploads)

# 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

Docker

# 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 .

Desktop Apps

Download from opensunsama.com/download or build from source:

cd apps/desktop
bun run tauri build

Tech Stack

React 19

TypeScript

Tailwind

PostgreSQL

Bun

Tauri

Architecture

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

Roadmap

We ship fast. Here's what's coming:

• Core task management with priorities
• Time blocking calendar
• MCP server for AI agents (24 tools)
• Desktop apps (macOS, Windows, Linux)
• Mobile apps (iOS, Android)
• Rich text notes with file attachments
• API key authentication with scopes
• Calendar sync (Google Calendar, Outlook) — Q1 2026
• Recurring tasks — Q1 2026
• Team workspaces — Q2 2026
• Integrations (Linear, GitHub, Jira, Notion) — Q2 2026
• Analytics dashboard — Q2 2026
• AI auto-scheduling — Q3 2026

Contributing

We love contributions! Open Sunsama is built by the community, for the community.

Ways to Contribute

• Report bugs — Found an issue? Open a bug report
• Request features — Have an idea? Start a discussion
• Submit PRs — Code contributions are always welcome
• Improve docs — Help others get started
• Share — Star the repo and spread the word!

Development Setup

# 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.

Community

License

Open Sunsama is free for non-commercial use under a custom license.

Permitted:

• Personal use
• Educational use
• Non-profit organizations
• Open source projects
• Evaluation and testing

Requires enterprise license:

• Commercial use
• Use in products sold for profit
• Production use by for-profit companies

See LICENSE for full details.

Acknowledgments

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.}