Sunsama MCP Server

A Model Context Protocol (MCP) server that provides comprehensive task management capabilities through the Sunsama API. This server enables AI assistants to access Sunsama tasks, create new tasks, mark tasks complete, and manage your productivity workflow.

Features

Task Management

Create Tasks - Create new tasks with notes, time estimates, due dates, and stream assignments
Read Tasks - Get tasks by day with completion filtering, access backlog tasks
Update Tasks - Mark tasks as complete with custom timestamps
Delete Tasks - Permanently remove tasks from your workspace

User & Stream Operations

User Information - Access user profile, timezone, and group details
Stream Management - Get streams/channels for project organization
Dual Transport - Support for both stdio and HTTP stream MCP transports

Installation

Prerequisites

Bun runtime (for development)
Sunsama account with API access

Using NPX (Recommended)

No installation required! Use directly with:

npx mcp-sunsama

Development Setup

Clone the repository:

git clone https://github.com/robertn702/mcp-sunsama.git
cd mcp-sunsama

Install dependencies:

bun install

Set up your environment variables:

cp .env.example .env
# Edit .env and add your Sunsama credentials

Environment variables:

SUNSAMA_EMAIL - Your Sunsama account email (required for stdio transport)
SUNSAMA_PASSWORD - Your Sunsama account password (required for stdio transport)
SUNSAMA_SESSION_TOKEN - Alternative session token authentication (optional)
PORT - Server port for HTTP transport (default: 3002)
MCP_TRANSPORT - Transport type: stdio or httpStream (default: stdio)

Usage

Running the Server

Stdio Transport (default):

bun run src/main.ts

HTTP Stream Transport:

MCP_TRANSPORT=httpStream PORT=3002 bun run src/main.ts

Claude Desktop Configuration

Add this configuration to your Claude Desktop MCP settings:

{
  "mcpServers": {
    "sunsama": {
      "command": "npx",
      "args": ["mcp-sunsama"],
      "env": {
        "SUNSAMA_EMAIL": "your-email@example.com",
        "SUNSAMA_PASSWORD": "your-password"
      }
    }
  }
}

API Tools

Task Management

create-task - Create new tasks with optional properties
get-tasks-by-day - Get tasks for a specific day with completion filtering
get-tasks-backlog - Get backlog tasks
update-task-complete - Mark tasks as complete
delete-task - Delete tasks permanently

User & Stream Operations

get-user - Get current user information
get-streams - Get streams/channels for project organization

Development

Running in Development

bun run dev

Testing with MCP Inspector

bun run inspect

Then connect the MCP Inspector to test the tools interactively.

Build

bun run build

Authentication

Stdio Transport: Requires SUNSAMA_EMAIL and SUNSAMA_PASSWORD environment variables.

HTTP Transport: The Sunsama credentials are passed in the HTTP request. No environment variables needed.

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

Sunsama API Documentation
sunsama-api Library - The underlying API client
Model Context Protocol Documentation
Issue Tracker

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables AI assistants to manage tasks in Sunsama, including creating tasks, reading daily and backlog tasks, marking tasks complete, and organizing projects through streams.

Related MCP Servers

DeltaTask MCP Server
brysontang
A
security
A
license
A
quality
Provides API access to a locally-hosted task management system with features for creating, updating, and organizing tasks, including support for urgency levels, effort estimates, subtasks, and bi-directional sync with Obsidian markdown files.
Last updated -
12
3
Python
MIT License
Dida365 (TickTick) MCP Server
iamjzx
-
security
F
license
-
quality
Provides tools for AI assistants to interact with the Dida365 (TickTick) task management API, allowing management of tasks and projects after user authorization.
Last updated -
15
JavaScript
MCP Server for Asana
cristip73
-
security
A
license
-
quality
This server implementation allows AI assistants to interact with Asana's API, enabling users to manage tasks, projects, workspaces, and comments through natural language requests.
Last updated -
408
TypeScript
MIT License
Divide and Conquer MCP Server
landicefu
-
security
A
license
-
quality
Enables AI agents to break down complex tasks into manageable pieces using a structured JSON format with task tracking, context preservation, and progress monitoring capabilities.
Last updated -
12
2
JavaScript
MIT License

View all related MCP servers

Sunsama MCP Server