Sunsama

Access Sunsama via MCP (Model Context Protocol) with managed authentication.

Reference

Task Management

Tool	Description
`search_tasks`	Search tasks by term
`create_task`	Create a new task
`edit_task_title`	Update task title
`delete_task`	Delete a task
`mark_task_as_completed`	Mark task complete
`mark_task_as_incomplete`	Mark task incomplete
`append_task_notes`	Add notes to task
`edit_task_time_estimate`	Set time estimate
`edit_task_recurrence_rule`	Set recurrence
`get_task_time_estimate`	Get AI time estimate
`restore_task`	Restore deleted task

Subtasks

Tool	Description
`add_subtasks_to_task`	Add subtasks
`edit_subtask_title`	Update subtask title
`mark_subtask_as_completed`	Mark subtask complete
`mark_subtask_as_incomplete`	Mark subtask incomplete

Backlog

Tool	Description
`get_backlog_tasks`	List backlog tasks
`move_task_to_backlog`	Move task to backlog
`move_task_from_backlog`	Move from backlog to day
`reposition_task_in_backlog`	Reorder backlog task
`change_backlog_folder`	Change task folder
`create_braindump_task`	Create backlog task

Scheduling

Tool	Description
`move_task_to_day`	Reschedule task
`reorder_tasks`	Reorder day's tasks
`timebox_a_task_to_calendar`	Block time for task
`set_shutdown_time`	Set daily end time

Calendar Events

Tool	Description
`create_calendar_event`	Create calendar event
`delete_calendar_event`	Delete calendar event
`move_calendar_event`	Reschedule event
`import_task_from_calendar_event`	Import event as task
`set_calendar_event_allow_task_projections`	Toggle task overlap
`accept_meeting_invite`	Accept meeting
`decline_meeting_invite`	Decline meeting

Time Tracking

Tool	Description
`start_task_timer`	Start timer
`stop_task_timer`	Stop timer

Channels & Objectives

Tool	Description
`create_channel`	Create channel/context
`add_task_to_channel`	Assign task to channel
`create_weekly_objective`	Create weekly goal
`align_task_with_objective`	Link task to objective

Tool	Description
`get_archived_tasks`	List archived tasks
`unarchive_task`	Restore archived task

Email Integration

Tool	Description
`list_email_threads`	List email threads
`create_follow_up_task_from_email`	Create task from email
`delete_email_thread`	Delete email thread
`mark_email_thread_as_read`	Mark email as read

Recurring Tasks

Tool	Description
`delete_all_incomplete_recurring_task_instances`	Delete future recurrences
`update_all_incomplete_recurring_task_instances`	Update future recurrences

Settings & Preferences

Tool	Description
`toggle_auto_import_events`	Toggle event auto-import
`update_calendar_preferences`	Update calendar settings
`update_import_event_filters`	Set event filters
`log_user_feedback`	Submit feedback

Search Tasks

Search for tasks by keyword:

POST /sunsama/search_tasks
Content-Type: application/json

{
  "searchTerm": "meeting"
}

Response:

{
  "content": [
    {
      "type": "text",
      "text": "{\"tasks\":[{\"_id\":\"69a6bf3a04d3cd0001595308\",\"title\":\"Team meeting prep\",\"scheduledDate\":\"2026-03-03\",\"completed\":false}]}"
    }
  ],
  "isError": false
}

Create Task

Create a new task scheduled for a specific day:

POST /sunsama/create_task
Content-Type: application/json

{
  "title": "Review quarterly report",
  "day": "2026-03-03",
  "alreadyInTaskList": false
}

Response:

{
  "content": [
    {
      "type": "text",
      "text": "{\"success\":true,\"task\":{\"_id\":\"69a6bf3a04d3cd0001595308\",\"title\":\"Review quarterly report\",\"notes\":\"\",\"timeEstimate\":\"20 minutes\",\"sortOrder\":-1772535610535,\"isPersonal\":false,\"isWork\":true,\"isPrivate\":false,\"isArchived\":false,\"completed\":false,\"isBacklogged\":false,\"scheduledDate\":\"2026-03-03\",\"subtasks\":[],\"channel\":\"work\",\"folder\":null,\"timeboxEventIds\":[]}}"
    }
  ],
  "isError": false
}

Get Backlog Tasks

List all tasks in the backlog:

POST /sunsama/get_backlog_tasks
Content-Type: application/json

{}

Response:

{
  "content": [
    {
      "type": "text",
      "text": "{\"tasks\":[],\"queryId\":\"bb7d004a-0b29-49d9-8345-6d9037786fbb\",\"totalPages\":1}"
    }
  ],
  "isError": false
}

Mark Task as Completed

POST /sunsama/mark_task_as_completed
Content-Type: application/json

{
  "taskId": "69a6bf3a04d3cd0001595308",
  "finishedDay": "2026-03-03"
}

Add Subtasks to Task

POST /sunsama/add_subtasks_to_task
Content-Type: application/json

{
  "taskId": "69a6bf3a04d3cd0001595308",
  "subtasks": [
    {"title": "Step 1: Research"},
    {"title": "Step 2: Draft outline"},
    {"title": "Step 3: Review"}
  ]
}

Create Calendar Event

POST /sunsama/create_calendar_event
Content-Type: application/json

{
  "title": "Team standup",
  "startDate": "2026-03-03T09:00:00"
}

Move Task to Day

Reschedule a task to a different day:

POST /sunsama/move_task_to_day
Content-Type: application/json

{
  "taskId": "69a6bf3a04d3cd0001595308",
  "calendarDay": "2026-03-04"
}

Timebox Task to Calendar

Block time for a task on your calendar:

POST /sunsama/timebox_a_task_to_calendar
Content-Type: application/json

{
  "taskId": "69a6bf3a04d3cd0001595308",
  "startDate": "2026-03-03",
  "startTime": "14:00"
}

Create Weekly Objective

POST /sunsama/create_weekly_objective
Content-Type: application/json

{
  "title": "Complete Q1 planning",
  "weekStartDay": "2026-03-03"
}

Create Braindump Task (Backlog)

Add a task to backlog with time bucket:

POST /sunsama/create_braindump_task
Content-Type: application/json

{
  "title": "Research new tools",
  "timeBucket": "in the next month"
}

Time bucket options:

"in the next two weeks"
"in the next month"
"in the next quarter"
"in the next year"
"someday"
"never"

Start/Stop Task Timer

POST /sunsama/start_task_timer
Content-Type: application/json

{
  "taskId": "69a6bf3a04d3cd0001595308"
}

POST /sunsama/stop_task_timer
Content-Type: application/json

{
  "taskId": "69a6bf3a04d3cd0001595308"
}

Set Shutdown Time

Set when your workday ends:

POST /sunsama/set_shutdown_time
Content-Type: application/json

{
  "calendarDay": "2026-03-03",
  "hour": 18,
  "minute": 0
}

Resources

Sunsama

Sunsama

On this page