# 将 Sunsama MCP 接入 Open Flow

Source: https://openflow.run/zh-cn/integrations/sunsama_mcp/

[全部集成](https://openflow.run/zh-cn/integrations/)

把积压任务安排成一段专注工作时间。

*   [59 个工具](https://openflow.run/zh-cn/integrations/sunsama_mcp/#integration-actions)
*   OAuth 2.0
*   效率工具

[连接 Sunsama MCP](https://console.openflow.run/connections/sunsama_mcp)

每月 20,000 次免费应用调用（付费服务另计）

## 可以做什么

查找任务、调整计划日期、补充笔记并创建日历时间块；计划执行日期和截止日期分别设置。

### 安排待办任务

查找待办任务并移动至指定日期。

### 安排专注时间块

为现有任务创建日历时间块。

## 所有工具

59 个工具

### Create Task

创建单个任务，包含标题、可选备注（Markdown）和预计时间。默认安排到某一天；改为传递 \`backlog\` 以将其暂存到待办事项中。这也是用于链接到另一个工具中项目的任务工具——传递 \`integrationUrl\`，这对待办事项任务同样有效。

`sunsama_mcp.create_task`

### Reposition Task In Backlog

通过将任务移动到特定的时间桶（时间范围）和位置（追加/前置）来重新定位积压任务。

`sunsama_mcp.reposition_task_in_backlog`

### Change Backlog Folder

将一个或多个任务移动到积压文件夹。如果 folderId 为 null，则从当前文件夹中移除任务。

`sunsama_mcp.change_backlog_folder`

### Align Task With Objective

将任务与目标对齐。

`sunsama_mcp.align_task_with_objective`

### Add Task To Channel

将任务添加到频道。

`sunsama_mcp.add_task_to_channel`

### Move Task To Day

将任务移动或推迟到特定日期。

`sunsama_mcp.move_task_to_day`

### Move Task From Backlog

将任务移出积压并放到特定日期。

`sunsama_mcp.move_task_from_backlog`

### Unarchive Task

取消归档任务并将其移动到特定日期；如果未提供日期，则移动到积压。

`sunsama_mcp.unarchive_task`

### Move Task To Backlog

将任务移动到积压。如果用户要求您将任务移动到特定日期，则应使用 move\_task\_to\_day 工具，而非此工具。

`sunsama_mcp.move_task_to_backlog`

### Get Task Time Estimate

获取任务的时间估算（以分钟为单位）。

`sunsama_mcp.get_task_time_estimate`

### Edit Task Recurrence Rule

更新现有任务的重复规则。这是临时暂停或跳过重复任务特定时间段（例如假期、休假）的首选工具。通过结合 deleteOldInstancesAfter（清除跳过期间的实例）和 firstOccurrenceOnOrAfter（之后重新开始系列），您可以保持重复性同时适应临时中断——这与 delete\_all\_incomplete\_recurring\_task\_instances 不同，后者会永久终止系列。当提供 firstOccurrenceOnOrAfter 时，这会分叉重复系列：从该日期开始新系列，旧系列在前一天结束。

`sunsama_mcp.edit_task_recurrence_rule`

### Edit Task Title

更新现有任务的标题。

`sunsama_mcp.edit_task_title`

### Edit Task Due Date

设置或清除任务的截止日期。这是硬性截止日期，而非任务计划/排程的日期（请使用 move\_task\_to\_day 进行该操作）。

`sunsama_mcp.edit_task_due_date`

### Edit Task Time Estimate

更新现有任务的时间估算。

`sunsama_mcp.edit_task_time_estimate`

### Edit Task Notes

用新的 Markdown 内容替换现有任务的备注正文。整个备注字段将被覆盖——使用 append\_task\_notes 在现有备注基础上追加而不替换。

`sunsama_mcp.edit_task_notes`

### Append Task Notes

将 Markdown 内容追加到现有任务备注的末尾。现有备注保留；新内容添加在其下方，并用水平规则分隔。使用 edit\_task\_notes 完全替换备注正文。

`sunsama_mcp.append_task_notes`

### Delete Task

删除现有任务。

`sunsama_mcp.delete_task`

### Add Subtasks To Task

向现有任务添加多个子任务。请勿用于将现有任务合并为子任务。

`sunsama_mcp.add_subtasks_to_task`

### Restore Task

将任务从已删除更改为未删除。

`sunsama_mcp.restore_task`

### Mark Task As Completed

将任务标记为已完成。也可用于将任务移动到之前的日期，这会自动完成任务。

`sunsama_mcp.mark_task_as_completed`

### Mark Task As Incomplete

将任务标记为未完成。

`sunsama_mcp.mark_task_as_incomplete`

### Edit Subtask Title

更新现有子任务的标题。

`sunsama_mcp.edit_subtask_title`

### Mark Subtask As Completed

将现有任务的子任务标记为已完成。

`sunsama_mcp.mark_subtask_as_completed`

### Mark Subtask As Incomplete

将现有任务的子任务标记为未完成。

`sunsama_mcp.mark_subtask_as_incomplete`

### Reorder Tasks

根据提供的 taskIds 顺序重新排序日历日的任务。

`sunsama_mcp.reorder_tasks`

### Get Backlog Tasks

获取用户的积压任务

`sunsama_mcp.get_backlog_tasks`

### Get Archived Tasks

获取用户的已归档任务

`sunsama_mcp.get_archived_tasks`

### Search Tasks

搜索任务。返回与搜索词匹配或相似的任务。

`sunsama_mcp.search_tasks`

### Update All Incomplete Recurring Task Instances

更新重复任务的所有未完成实例以匹配当前任务。当您希望将对重复任务一个实例所做的更改应用于所有未来的未完成实例时，此功能很有用。

`sunsama_mcp.update_all_incomplete_recurring_task_instances`

### Delete All Incomplete Recurring Task Instances

永久删除重复任务的未完成实例并终止系列，防止将来创建任何实例。此操作不可逆。当提供 afterDate 时，仅删除该日期之后的实例，并在该日期终止系列。省略时，删除所有未完成实例。警告：如果用户希望临时跳过一段时间（例如假期）并在之后恢复系列，请勿使用此工具——请改用 edit\_task\_recurrence\_rule 配合 deleteOldInstancesAfter 和 firstOccurrenceOnOrAfter。

`sunsama_mcp.delete_all_incomplete_recurring_task_instances`

### Start Task Timer

启动任务或子任务的计时器。如果提供 subtaskId，则为该特定子任务启动计时器。

`sunsama_mcp.start_task_timer`

### Stop Task Timer

停止任务或子任务的计时器。如果提供 subtaskId，则为该特定子任务停止计时器。

`sunsama_mcp.stop_task_timer`

### Set Backlog Priority

设置任务的积压优先级。积压优先级会持久保留，并用于积压中的任务。有效值："urgent"、"high"、"medium"、"low"、"none"。设置为 null 以清除。

`sunsama_mcp.set_backlog_priority`

### Set Daily Priority

设置任务的每日优先级。每日优先级与特定日期绑定，并在该日期之后衰减。有效值："urgent"、"important"、"normal"、"low"。设置为 null 以清除。日期自动从任务确定。

`sunsama_mcp.set_daily_priority`

### Get Task By Id

通过 Sunsama 任务 ID 获取单个任务。返回完整任务详情，包括集成信息。

`sunsama_mcp.get_task_by_id`

### Move Calendar Event

更新日历事件的日期、时间和/或持续时间。

`sunsama_mcp.move_calendar_event`

### Create Calendar Event

创建新的日历事件。

`sunsama_mcp.create_calendar_event`

### Timebox A Task To Calendar

将任务时间块化到日历。这将为任务创建时间块事件。这也可能被称为 "scheduling" 任务或"将任务添加到日历"。

`sunsama_mcp.timebox_a_task_to_calendar`

### Delete Calendar Event

移除日历事件并删除所有关联任务。如果事件是会议，则任何访问角色都可以移除该事件。否则，只有所有者或写入者可以移除事件。注意：如果事件是会议且用户是所有者或写入者，这将为所有与会者移除该事件。

`sunsama_mcp.delete_calendar_event`

### Import Task From Calendar Event

将日历事件导入为任务。

`sunsama_mcp.import_task_from_calendar_event`

### Accept Meeting Invite

确认用户被邀请参加的会议的出席。

`sunsama_mcp.accept_meeting_invite`

### Decline Meeting Invite

拒绝用户被邀请参加的会议的出席。

`sunsama_mcp.decline_meeting_invite`

### Set Calendar Event Allow Task Projections

设置是否允许任务在与日历事件相同的时间自动投影（排程）。设置为 true 时，任务可以在事件期间自动投影。设置为 false 时，任务不能在事件期间自动投影。注意：这仅影响自动投影；用户仍可在此事件期间手动时间块化任务。

`sunsama_mcp.set_calendar_event_allow_task_projections`

### Toggle Auto Import Events

启用或禁用日历事件自动导入到每日任务列表。

`sunsama_mcp.toggle_auto_import_events`

### Update Import Event Filters

更新确定哪些日历事件被排除在自动导入之外的排除筛选器。匹配任何这些筛选器的事件将不会被自动导入。

`sunsama_mcp.update_import_event_filters`

### Update Calendar Preferences

更新特定日历的偏好设置，包括它是否是任务的默认日历、事件的默认日历，以及是否包含在事件的自动导入中。

`sunsama_mcp.update_calendar_preferences`

### Create Weekly Objective

创建新的每周目标。

`sunsama_mcp.create_weekly_objective`

### Get Daily Highlights

获取用户的每日亮点列表（工作日结束时的日志条目）。返回已发布的每日总结，格式为 Markdown。如果省略 startDate 和 endDate，则仅返回最近的一条。

`sunsama_mcp.get_daily_highlights`

### Set Shutdown Time

为特定日期设置关机时间。

`sunsama_mcp.set_shutdown_time`

### Create Channel

为用户创建新频道。

`sunsama_mcp.create_channel`

### Rename Channel

重命名用户的某个频道。接受频道 ID，而不是频道名称——请使用 search\_channels 工具将用户提到的名称解析为 ID。重命名仅更改频道的标签；分配给该频道的任务、目标和日历事件保持不变。

`sunsama_mcp.rename_channel`

### Delete Channel

删除用户的某个频道。接受频道 ID，而不是频道名称——请使用 search\_channels 工具将用户提到的名称解析为 ID。频道中的任务、目标和日历事件不会被删除，但会失去频道分配，且无法通过撤销此操作来重新分配。删除类别也会取消其内部频道的分类。此操作无法撤销，因此调用前请与用户确认。

`sunsama_mcp.delete_channel`

### Search Channels

按含义搜索用户的频道，而不仅仅是精确名称。返回按相关性排序的最接近匹配的频道，因此“客户工作”可以匹配名为“Acme Corp”的频道。使用此工具将用户提到的频道解析为频道 ID，然后再将任务分配给它。

`sunsama_mcp.search_channels`

### List Resources

列出此 MCP 服务器暴露的所有可用资源和资源模板。当客户端不支持 MCP 资源协议时，使用此工具发现可用的数据源。 返回资源数组，每个资源包含： - name：资源标识符 - uri：静态 URI（对于固定资源）或 uri\_template（对于参数化资源） - description：资源提供的内容 - mimeType：返回的内容类型

`sunsama_mcp.list_resources`

### Read Resource

通过 URI 读取特定资源。当客户端不支持 MCP 资源协议时，使用此工具从资源获取数据。 对于静态资源，传递来自 list\_resources 的精确 URI。 对于模板化资源，用实际值填充占位符。 示例：如果 list\_resources 显示 uri\_template "sunsama://tasks/{calendarDay}"， 则使用 uri "sunsama://tasks/2025-01-15" 调用此工具以获取该天的任务。

`sunsama_mcp.read_resource`

### List Help Articles

将 Sunsama 帮助中心文章作为目录列出：每个条目包含 id、标题、描述、类别和 url。当用户询问 Sunsama 功能如何工作、Sunsama 能做什么或不能做什么，或者当您不确定产品行为或限制时，请使用此工具。从列表中选择最相关的文章，然后使用其 id 调用 "get\_help\_article" 来阅读它，并根据文档回答，而不是猜测。您也可以与用户分享文章 url。

`sunsama_mcp.list_help_articles`

### Get Help Article

获取单个 Sunsama 帮助中心文章的全文。首先调用 "list\_help\_articles" 找到相关文章，然后在此处传递其 id。返回文章标题、url 和纯文本正文，以便您根据文档回答用户的问题。

`sunsama_mcp.get_help_article`

### List Tools

发现当前 Sunsama 任务和每日规划 MCP 工具及其实时输入模式。

`sunsama_mcp.list_tools`

### Call Tool

使用 JSON 参数调用 Sunsama MCP 工具。

`sunsama_mcp.call_tool`

没有符合搜索条件的工具。

## 将 Sunsama MCP 接入 Open Flow

[连接 Sunsama MCP](https://console.openflow.run/connections/sunsama_mcp)

每月 20,000 次免费应用调用（付费服务另计）
