Skip to content

Latest commit

 

History

History
168 lines (130 loc) · 4.36 KB

README.md

File metadata and controls

168 lines (130 loc) · 4.36 KB

Sunsama MCP Routing Reference

App name: sunsama Base URL proxied: MCP server

Connection Management

Manage MCP connections at https://ctrl.maton.ai.

List Connections

GET https://ctrl.maton.ai/connections?app=sunsama&method=MCP&status=ACTIVE
Authorization: Bearer $MATON_API_KEY

Create Connection

POST https://ctrl.maton.ai/connections
Content-Type: application/json
Authorization: Bearer $MATON_API_KEY

{
  "app": "sunsama",
  "method": "MCP"
}

API Path Pattern

/sunsama/{tool-name}

MCP Reference

All MCP tools use POST method:

Tool Description Schema
search_tasks Search tasks by keyword schema
create_task Create a new task schema
edit_task_title Update task title schema
delete_task Delete a task schema
mark_task_as_completed Mark task complete schema
mark_task_as_incomplete Mark task incomplete schema
append_task_notes Add notes to task schema
edit_task_time_estimate Set time estimate schema
add_subtasks_to_task Add subtasks schema
get_backlog_tasks List backlog tasks schema
move_task_to_backlog Move task to backlog schema
move_task_from_backlog Move from backlog to day schema
move_task_to_day Reschedule task schema
create_calendar_event Create calendar event schema
timebox_a_task_to_calendar Block time for task schema
start_task_timer Start timer schema
stop_task_timer Stop timer schema
create_weekly_objective Create weekly goal schema
create_braindump_task Create backlog task schema
create_channel Create channel/context schema

Common Endpoints

Search Tasks

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

{
  "searchTerm": "meeting"
}

Create Task

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\",\"scheduledDate\":\"2026-03-03\",\"completed\":false}}"
    }
  ],
  "isError": false
}

Get Backlog Tasks

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

{}

Mark Task as Completed

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

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

Create Braindump Task

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"

Timebox Task to Calendar

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

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

Notes

  • All task IDs are MongoDB ObjectIds (24-character hex strings)
  • Date format: YYYY-MM-DD for days, ISO 8601 for datetimes
  • MCP tool responses wrap content in {"content": [{"type": "text", "text": "..."}], "isError": false} format
  • The text field contains JSON-stringified data that should be parsed
  • If multiple Sunsama connections exist, specify which to use with Maton-Connection header

Resources