Sunsama
@robertn702
A comprehensive Model Context Protocol (MCP) server that integrates Sunsama's daily planning and task management capabilities into AI assistants. Provides full CRUD operations for tasks, enabling automated workflow management and productivity optimization through the Sunsama API.
概要
What is Sunsama?
A Model Context Protocol (MCP) server that provides comprehensive task management capabilities through the Sunsama API. It enables AI assistants to access Sunsama tasks, create new tasks, mark tasks complete, and manage your productivity workflow.
How to use Sunsama?
Install with npx (recommended): npx mcp-sunsama. For development, clone the repository, install dependencies with Bun, set environment variables (SUNSAMA_EMAIL, SUNSAMA_PASSWORD, optionally SUNSAMA_SESSION_TOKEN, PORT, MCP_TRANSPORT), then run bun run src/main.ts. Configure with Claude Desktop by adding a sunsama entry in mcpServers with the npx command and credentials.
Key features of Sunsama
- Create tasks with notes, time estimates, due dates, and stream assignments
- Read tasks by day with completion filtering and access backlog tasks
- Update tasks (mark complete, reschedule, move to backlog)
- Delete tasks permanently from your workspace
- Access user profile, timezone, and stream/channel information
- Support for both stdio and HTTP stream MCP transports
Use cases of Sunsama
- AI assistants retrieving and managing daily tasks from Sunsama
- Automated task creation and scheduling via natural language requests
- Rescheduling tasks or moving them to backlog based on user commands
- Permanently removing tasks as part of workflow cleanup
FAQ from Sunsama
What authentication methods does Sunsama support?
Stdio transport requires SUNSAMA_EMAIL and SUNSAMA_PASSWORD environment variables. HTTP transport passes credentials in the HTTP request instead; no environment variables needed.
What runtime does Sunsama require?
Bun runtime is required for development. For production use via npx, no local installation is needed.
What transports does Sunsama support?
It supports stdio (default) and HTTP stream MCP transports, set via the MCP_TRANSPORT environment variable.
Where can I find the underlying API client?
The Sunsama MCP server uses the sunsama-api library.
