自动化 Agenda

你可以通过自动化 Agenda 来创建强大的工作流程，既可以在较高层面上进行，例如使用 Siri 快捷指令或"快捷指令"App，也可以在较低层面上进行，例如通过 x-callback-url 支持。可能性是无穷的！

App 快捷指令

从 Agenda 15 开始，App 快捷指令让你能够通过"快捷指令"App 在 Agenda 中快速完成一项或多项任务。将多个 Agenda 快捷指令组合起来，还可以选择性地与其他 App 的快捷指令搭配，从而创建并自动化你的工作流程。既可以简单到从 iPad 主屏幕打开某条特定笔记、轻点两下手机背面来创建新笔记，也可以复杂到从不同 App 中抓取今天需要做的所有事项，并一键创建一个新项目。

Agenda for iOS 还支持 Siri 快捷指令，可用于打开某条笔记、项目或概览等常见操作。

在"快捷指令"中搜索笔记

你可以使用"快捷指令"App 中的"搜索笔记"操作来查找符合特定条件的笔记。此功能也可通过 x-callback-url 使用。搜索查询支持诸如 \color、\done、\pinned 等操作语法，让你在自动化流程中拥有与 App 内搜索同样强大的能力。

Siri

你可以使用 Siri 来搜索笔记并与 Agenda 交互。例如，只需让 Siri 在 Agenda 中搜索某些内容，你就可以直接预览结果。Siri 还支持 Agenda 与其他 App 之间更丰富的数据交换。

控制中心

在 iOS 上，Agenda 提供了控制中心按钮，让你无需先打开 App 即可快速跳转到"今天"或"简达"概览。你可以在设备的控制中心设置中添加这些按钮。

x-callback-url 支持

Agenda 还支持 x-callback url。它们让你能够在多个 App 之间衔接工作流程，以及／或者自动执行 Agenda 内的某些操作。Apple 的"快捷指令"App 同样支持它。

x-callback-url 快速入门：

URL 方案为 agenda 或 agenda-notes
目前的命令包括 on-the-agenda、today、open-project 等
对于 “open-project” 和 “open-note”，你可以使用 title 参数来指定目标。
与往常一样，你可以通过可选的 x-success 和 x-error 参数提供回调 URL。

例如，若要在 Agenda 中打开名为"Meeting With Peta"的笔记，可以使用这个 URL： agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Agenda 23 新增： move-note 操作让你可以从其他 App 或快捷指令中将笔记在项目之间移动： agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

MCP（模型上下文协议）集成

Agenda 在 macOS 上内置了 MCP 服务器，让 AI 助理能够与你的笔记、项目和分类交互。MCP 是一种开放协议，Claude Code、Claude Desktop、Cursor 和 Codex 等工具使用它来与 App 通信。

启用 MCP 服务器

MCP 服务器默认处于关闭状态。若要启用它，请前往 Agenda 菜单并选取 Integrations > Enable MCP。服务器在你的 Mac 上以 http://127.0.0.1:16106/mcp 本地运行，且只能从你自己的机器访问。

Integrations 菜单还提供了用于复制各种 AI 工具连接配置命令的选项，以及一个可直接下载并安装的 Claude Desktop 插件。

可用工具

MCP 服务器为 AI 助理提供了以下工具：

查找与读取

search_notes — 按文本、标签、日期及其他条件搜索你的笔记
get_note — 获取某条特定笔记的完整内容
get_selection — 获取你在 Agenda 中选中的笔记或项目，这样你就可以说"这条笔记"
list_projects — 列出所有项目，可选择包含已归档的项目
list_categories — 列出所有分类
list_templates — 列出你的笔记模板，以便用模板创建笔记
list_overviews — 列出你存储的概览
list_attachments — 列出笔记中的文件和绘图 （Agenda 23.4 新增）
get_attachment — 获取附件的原始文件 （Agenda 23.4 新增）

在 Agenda 中显示

open_note — 在 Agenda 中打开某条特定笔记
open — 将 Agenda 置于前台，并前往"今天"、“简达”、某个搜索、某个项目或某个存储的概览

创建与更改

create_note — 在某个项目中创建新笔记，可选择添加文件附件
append_to_note — 向现有笔记添加内容和／或文件附件
edit_note — 修改现有笔记的内容，可选择添加文件附件
move_note — 将现有笔记移动到其他项目
trash_note — 将笔记移到废纸篓
untrash_note — 从废纸篓中恢复笔记
create_project — 创建新项目
update_project — 重命名项目、将其移到其他分类、更改其排序方式、将其归档，或将其移到废纸篓再移回
create_category — 创建新分类
update_category — 重命名分类、更改其颜色、将其嵌套到其他分类下，或将其移回顶层

导出

export_pdf — 将多条笔记或整个项目存储为一个 PDF 文件

通过 MCP 无法永久删除任何内容。助理移到废纸篓的笔记或项目会一直留在那里，直到你清倒废纸篓；而分类则完全无法删除。

连接 AI 工具

若要将 AI 工具连接到 Agenda 的 MCP 服务器，请使用 Integrations 菜单中的配置命令，或手动进行设置：

Claude Code：

claude mcp add --transport http agenda http://localhost:16106/mcp

Claude Desktop / Cursor： 在你的 MCP 配置中使用 npx mcp-remote http://localhost:16106/mcp 作为命令。或者，直接从 Integrations 菜单安装 Claude Desktop 插件。

Codex： 将以下内容添加到 ~/.codex/config.toml：

[mcp_servers.agenda]
url = "http://127.0.0.1:16106/mcp"

附件

create_note、append_to_note 和 edit_note 工具支持为笔记添加文件附件。附件以 base64 编码数据的形式发送，因此 AI 助理可以从你的 Mac 上读取文件、进行编码，并一步将其附加到笔记中。例如，你可以让 AI 助理"把这个 PDF 附到我的会议笔记里"，剩下的事情它都会处理好。

每个附件都需要一个 filename（带扩展名，以便 Agenda 知道文件类型）和 base64 编码的文件 data。你还可以使用 displayStyle（inline、thumbnail、thumbnail-with-details 或 full-width）和 displaySize（small、medium 或 large）来控制附件的显示方式。

限制：每次请求最多 20 个附件，文件数据总量最大为 100 MB。

从笔记中取出文件（Agenda 23.4 新增）

助理还可以从笔记中取回文件，例如读取你附加的 PDF，或将其上传到别处。list_attachments 工具会列出笔记中的文件和绘图。随后，get_attachment 工具会为原始文件制作一份只读副本，使用你在 Agenda 中看到的名称，并把它的位置告诉助理。该副本是临时的：Agenda 会在下次启动时将其移除。

如果你的 AI 工具无法读取 Agenda 文件夹中的文件，它也可以改为直接请求文件内容（最大 100 MB，仅限文件）。文件夹或包会以文件夹的形式提供，绘图则以其预览图像的形式提供。已锁定笔记中的附件不可用。

帮助资源

MCP 服务器还提供了涵盖 Agenda 文档中常见主题的帮助资源，因此 AI 助理可以查阅各项功能的工作方式，并就 Agenda 给出更好的回答。

你可以问些什么

一旦你的 AI 工具连接成功，它就能按你的要求读取和修改笔记。以下是一些效果不错的示例：

“把我这周的会议笔记总结成一条新笔记，放到 Weekly Reviews 项目里。”
“找出所有标记了 #followup 且提到 Anna 的内容，并列出来。”
“把这个 PDF 里的行动事项添加到我的 Project Kickoff 笔记末尾。"（AI 也可以附加文件）
“把 ‘Q2 Planning’ 笔记从 Drafts 移到 Strategy 项目。”
“创建一个名为 Holiday 的新项目，并在里面加一份行李清单。”
“从我的 ‘March Billing’ 笔记中取出发票 PDF，告诉我总金额。”

由于 MCP 服务器在你的 Mac 上本地运行，你的笔记在传送到 AI 工具的过程中绝不会离开你的机器——只有助理读取或写入的特定文本才会经由它传送。

疑难解答

如果你的 AI 工具无法看到 Agenda：

是否已启用 MCP？ 请检查 Agenda > Integrations > Enable MCP。服务器运行时，该菜单项会变为 Disable MCP。
Agenda 是否正在运行？ 服务器运行在 Agenda App 内部——如果 Agenda 退出，服务器也会随之停止。
AI 工具在启用 MCP 后是否重新连接过？ 有些客户端会在启动时缓存连接。如果 AI 工具在你启用 MCP 之前就已运行，请重新启动它。
端口 16106 是否被其他程序占用？ 可以在"终端"中快速测试：curl http://127.0.0.1:16106/mcp 应当返回一个响应（而不是 “connection refused”）。

注意： MCP 服务器仅在 macOS 上可用。