Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Server port for HTTP transport | 3000 |
| SESSION_TTL | No | Session timeout in milliseconds | 3600000 |
| MAX_SESSIONS | No | Maximum concurrent sessions | 100 |
| TRANSPORT_MODE | No | Transport type: stdio or http | http |
| CLIENT_IDLE_TIMEOUT | No | Client idle timeout in milliseconds | 900000 |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Sunsama API Documentation | Documentation for the Sunsama API endpoints and data structures |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get-user | Get current user information including profile, timezone, and group details |
| get-tasks-backlog | Get tasks from the backlog |
| get-tasks-by-day | Get tasks for a specific day with optional filtering by completion status |
| get-archived-tasks | Get archived tasks with optional pagination |
| get-task-by-id | Get a specific task by its ID |
| create-task | Create a new task with optional properties |
| delete-task | Delete a task permanently |
| update-task-complete | Mark a task as complete with optional completion timestamp |
| update-task-snooze-date | Update task snooze date to reschedule tasks or move them to backlog |
| update-task-backlog | Move a task to the backlog |
| update-task-planned-time | Update the planned time (time estimate) for a task |
| update-task-notes | Update the notes content for a task |
| update-task-due-date | Update the due date for a task |
| update-task-text | Update the text/title of a task |
| update-task-stream | Update the stream/channel assignment for a task |
| get-streams | Get streams for the user's group (streams are called 'channels' in the Sunsama UI) |