Connect Sunsama MCP to Your AI Agent

Turn a backlog item into time reserved for focused work.

59 tools OAuth

Try a Sunsama MCP Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Sunsama MCP

Schedule a Backlog Task

Find a backlog task and move it to a chosen day.

/oo Sunsama MCP: Find [task] in my Sunsama backlog and move it to [day].

Timebox Focus Work

Create a calendar timebox for an existing task.

/oo Sunsama MCP: Put the selected Sunsama task on my calendar at [date and time] for [duration].

Start Working with Sunsama MCP

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Sunsama MCP

    Connect with Sunsama MCP OAuth authorization.

    Connect Sunsama MCP →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • An account with access to the Sunsama MCP resources used in your task.

Sunsama MCP Tools

Find tasks, adjust planned days, add notes, and create calendar timeboxes. Planned work dates and deadlines remain separate choices.

Schedule a Backlog Task

Find a backlog task and move it to a chosen day.

Timebox Focus Work

Create a calendar timebox for an existing task.

59 tools

Create Task

Creates a single task with a title, optional notes (markdown), and estimated time. Scheduled to a day by default; pass `backlog` instead to stage it in the backlog. This is also the tool for a task that links to an item in another tool — pass `integrationUrl`, which works for a backlog task too.

sunsama_mcp.create_task

Reposition Task In Backlog

Repositions a task within the backlog by moving it to a specific time bucket (horizon) and position (append/prepend).

sunsama_mcp.reposition_task_in_backlog

Change Backlog Folder

Moves one or more tasks to a backlog folder. If folderId is null, removes tasks from their current folder.

sunsama_mcp.change_backlog_folder

Align Task With Objective

Aligns a task with an objective.

sunsama_mcp.align_task_with_objective

Add Task To Channel

Adds a task to a channel.

sunsama_mcp.add_task_to_channel

Move Task To Day

Moves or defers a task to a specific date.

sunsama_mcp.move_task_to_day

Move Task From Backlog

Moves a task out of the backlog and onto a specific date.

sunsama_mcp.move_task_from_backlog

Unarchive Task

Unarchives a task and moves it to a specific date or the backlog if no date is provided.

sunsama_mcp.unarchive_task

Move Task To Backlog

Moves a task to the backlog. IF THE USER ASKS YOU TO MOVE A TASK TO A SPECIFIC DAY THEN YOU SHOULD USE THE move_task_to_day TOOL NOT THIS ONE.

sunsama_mcp.move_task_to_backlog

Get Task Time Estimate

Gets the time estimate for a task in minutes.

sunsama_mcp.get_task_time_estimate

Edit Task Recurrence Rule

Updates the recurrence rule of an existing task. This is the preferred tool for temporarily pausing or skipping a recurring task for a specific period (e.g. vacation, leave). By combining deleteOldInstancesAfter (to clear instances during the skip period) and firstOccurrenceOnOrAfter (to restart the series afterwards), you can maintain the recurrence while accommodating temporary breaks — unlike delete_all_incomplete_recurring_task_instances which permanently terminates the series. When firstOccurrenceOnOrAfter is provided, this forks the recurring series: a new series begins from that date and the old series ends the day before.

sunsama_mcp.edit_task_recurrence_rule

Edit Task Title

Updates the title of an existing task.

sunsama_mcp.edit_task_title

Edit Task Due Date

Sets or clears the due date of a task. This is the hard deadline, not the day the task is planned/scheduled for (use move_task_to_day for that).

sunsama_mcp.edit_task_due_date

Edit Task Time Estimate

Updates the time estimate of an existing task.

sunsama_mcp.edit_task_time_estimate

Edit Task Notes

Replaces the notes body of an existing task with new Markdown content. The full notes field is overwritten — use append_task_notes to add to existing notes without replacing them.

sunsama_mcp.edit_task_notes

Append Task Notes

Appends Markdown content to the end of an existing task's notes. Existing notes are preserved; the new content is added below them with a horizontal rule separator. Use edit_task_notes to replace the notes body entirely.

sunsama_mcp.append_task_notes

Delete Task

Deletes an existing task.

sunsama_mcp.delete_task

Add Subtasks To Task

Adds multiple subtasks to an existing task. Do not use for merging existing tasks in as subtasks.

sunsama_mcp.add_subtasks_to_task

Restore Task

Changes a task from deleted to not deleted.

sunsama_mcp.restore_task

Mark Task As Completed

Marks a task as completed. Can also be used to move a task to a previous day which auto-completes the task.

sunsama_mcp.mark_task_as_completed

Mark Task As Incomplete

Marks a task as incomplete.

sunsama_mcp.mark_task_as_incomplete

Edit Subtask Title

Updates the title of an existing subtask.

sunsama_mcp.edit_subtask_title

Mark Subtask As Completed

Marks a subtask of an existing task as completed.

sunsama_mcp.mark_subtask_as_completed

Mark Subtask As Incomplete

Marks a subtask of an existing task as incomplete.

sunsama_mcp.mark_subtask_as_incomplete

Reorder Tasks

Reorders tasks for the calendar day according to the provided order of taskIds.

sunsama_mcp.reorder_tasks

Get Backlog Tasks

Fetches the users backlog tasks

sunsama_mcp.get_backlog_tasks

Get Archived Tasks

Fetches the users archived tasks

sunsama_mcp.get_archived_tasks

Search Tasks

Searches for tasks. Returns tasks that match the search term or are similar to the search term.

sunsama_mcp.search_tasks

Update All Incomplete Recurring Task Instances

Updates all incomplete instances of a recurring task to match the current task. This is useful when you want to apply changes made to one instance of a recurring task to all future incomplete instances.

sunsama_mcp.update_all_incomplete_recurring_task_instances

Delete All Incomplete Recurring Task Instances

PERMANENTLY deletes incomplete instances of a recurring task and TERMINATES the series, preventing any future instances from ever being created. This is irreversible. When afterDate is provided, only instances after that date are deleted and the series is terminated at that date. When omitted, all incomplete instances are deleted. WARNING: If the user wants to temporarily skip a period (e.g. vacation) and resume the series afterwards, do NOT use this tool — use edit_task_recurrence_rule with deleteOldInstancesAfter and firstOccurrenceOnOrAfter instead.

sunsama_mcp.delete_all_incomplete_recurring_task_instances

Start Task Timer

Starts the timer for a task or subtask. If a subtaskId is provided, starts the timer for that specific subtask.

sunsama_mcp.start_task_timer

Stop Task Timer

Stops the timer for a task or subtask. If a subtaskId is provided, stops the timer for that specific subtask.

sunsama_mcp.stop_task_timer

Set Backlog Priority

Sets the backlog priority of a task. Backlog priority persists and is used for tasks in the backlog. Valid values: "urgent", "high", "medium", "low", "none". Set to null to clear.

sunsama_mcp.set_backlog_priority

Set Daily Priority

Sets the daily priority of a task. Daily priority is tied to a specific day and decays after that day. Valid values: "urgent", "important", "normal", "low". Set to null to clear. The date is automatically determined from the task.

sunsama_mcp.set_daily_priority

Get Task By Id

Fetches a single task by its Sunsama task ID. Returns full task details including integration information.

sunsama_mcp.get_task_by_id

Move Calendar Event

Updates a calendar event's date, time, and/or duration.

sunsama_mcp.move_calendar_event

Create Calendar Event

Creates a new calendar event.

sunsama_mcp.create_calendar_event

Timebox A Task To Calendar

Timeboxes a task to the calendar. This will create a timebox event for the task. This may also be referred to as "scheduling" a task or "adding a task to the calendar".

sunsama_mcp.timebox_a_task_to_calendar

Delete Calendar Event

Removes a calendar event and deletes all associated tasks. If the event is a meeting then any access role can remove the event. Otherwise only owners or writers can remove the event. Note: If the event is a meeting and the user is an owner or write this will remove the event for ALL attendees.

sunsama_mcp.delete_calendar_event

Import Task From Calendar Event

Imports a calendar event as a task.

sunsama_mcp.import_task_from_calendar_event

Accept Meeting Invite

Confirms attendance to a meeting that the user is invited to.

sunsama_mcp.accept_meeting_invite

Decline Meeting Invite

Decline attendance to a meeting that the user is invited to.

sunsama_mcp.decline_meeting_invite

Set Calendar Event Allow Task Projections

Sets whether tasks are allowed to be automatically projected (scheduled) at the same time as a calendar event. When set to true, tasks can be automatically projected during the event. When set to false, tasks cannot be automatically projected during the event. Note: This only affects automatic projections; users can still manually timebox tasks during this event.

sunsama_mcp.set_calendar_event_allow_task_projections

Toggle Auto Import Events

Enables or disables automatic importing of calendar events to the daily task list.

sunsama_mcp.toggle_auto_import_events

Update Import Event Filters

Updates the exclusion filters that determine which calendar events are excluded from automatic import. Events matching any of these filters will NOT be automatically imported.

sunsama_mcp.update_import_event_filters

Update Calendar Preferences

Updates preferences for a specific calendar including whether it is the default for tasks, default for events, and whether it is included in auto-importing of events.

sunsama_mcp.update_calendar_preferences

Create Weekly Objective

Creates a new weekly objective.

sunsama_mcp.create_weekly_objective

Get Daily Highlights

Gets a list of daily highlights (end of day journal entries of your work day) for the user. Returns published daily wraps in Markdown format. If startDate and endDate are omitted, returns only the most recent one.

sunsama_mcp.get_daily_highlights

Set Shutdown Time

Sets the shutdown time for a specific day.

sunsama_mcp.set_shutdown_time

Create Channel

Creates a new channel for the user.

sunsama_mcp.create_channel

Rename Channel

Renames one of the user's channels. Takes a channel ID, not a channel name — use the search_channels tool to resolve a name the user mentions into an ID first. Renaming only changes the channel's label; the tasks, objectives, and calendar events assigned to it stay assigned.

sunsama_mcp.rename_channel

Delete Channel

Deletes one of the user's channels. Takes a channel ID, not a channel name — use the search_channels tool to resolve a name the user mentions into an ID first. Tasks, objectives, and calendar events in the channel are not deleted, but they lose their channel assignment and cannot be reassigned by undoing this. Deleting a category also uncategorizes the channels inside it. This cannot be undone, so confirm with the user before calling it.

sunsama_mcp.delete_channel

Search Channels

Searches the user's channels by meaning, not just by exact name. Returns the closest matching channels ordered by relevance, so "client work" can match a channel named "Acme Corp". Use this to resolve a channel a user mentions into a channel ID before assigning tasks to it.

sunsama_mcp.search_channels

List Resources

Lists all available resources and resource templates exposed by this MCP server. Use this tool to discover what data sources are available when the client doesn't support the MCP resources protocol natively. Returns an array of resources, where each resource has: - name: The resource identifier - uri: The static URI (for fixed resources) OR uri_template (for parameterized resources) - description: What the resource provides - mimeType: The content type returned

sunsama_mcp.list_resources

Read Resource

Reads a specific resource by URI. Use this tool to fetch data from resources when the client doesn't support the MCP resources protocol natively. For static resources, pass the exact URI from list_resources. For templated resources, fill in the placeholders with actual values. Example: If list_resources shows uri_template "sunsama://tasks/{calendarDay}", you would call this with uri "sunsama://tasks/2025-01-15" to get tasks for that day.

sunsama_mcp.read_resource

List Help Articles

Lists Sunsama's help center articles as a catalog: each entry has an id, title, description, category, and url. Use this whenever the user asks how a Sunsama feature works, what Sunsama can or cannot do, or whenever you are unsure about product behavior or a limitation. Pick the most relevant article from the list, then call "get_help_article" with its id to read it and answer from the docs instead of guessing. You can also share the article url with the user.

sunsama_mcp.list_help_articles

Get Help Article

Fetches the full text of a single Sunsama help center article. First call "list_help_articles" to find the relevant article, then pass its id here. Returns the article title, url, and plain-text body so you can answer the user's question from the docs.

sunsama_mcp.get_help_article

List Tools

Discover the current Sunsama task and daily planning MCP tools with their live input schemas.

sunsama_mcp.list_tools

Call Tool

Call a Sunsama MCP tool with JSON arguments.

sunsama_mcp.call_tool

Frequently Asked Questions

Does scheduling a task change its deadline?

The planned day and the due date are separate. Say explicitly if you want to change the deadline too.

Can I add notes without replacing existing ones?

Yes. Ask to append the new notes rather than replace the task’s notes.

Connect Sunsama MCP

About Sunsama MCP ↗