自動化 Agenda

你可以透過自動化 Agenda 建立強大的工作流程，這既可以在高階層面上進行，例如使用 Siri 捷徑或「捷徑」應用程式，也可以在低階層面上進行，例如透過 x-callback-url 支援。可能性無窮無盡！

App 捷徑

從 Agenda 15 起，App 捷徑讓你能透過「捷徑」應用程式在 Agenda 中快速完成一項或多項任務。結合多個 Agenda 捷徑，並選擇性地搭配其他應用程式的捷徑，你就能建立並自動化你的工作流程。從單純地從 iPad 主畫面開啟某則特定筆記、在手機背面點兩下後觸發新筆記，到從不同應用程式抓取你今天所有待辦事項並一鍵建立新專案的複雜工作流程，都能實現。

iOS 版 Agenda 也支援 Siri 捷徑，可用於開啟某則筆記、專案或概覽等常見動作。

在「捷徑」中搜尋筆記

你可以在「捷徑」應用程式中使用「搜尋筆記」動作，來尋找符合特定條件的筆記。這也可以透過 x-callback-url 使用。搜尋查詢支援 \color、\done、\pinned 等動作語法，讓你在自動化流程中擁有與應用程式內搜尋相同的強大能力。

Siri

你可以使用 Siri 搜尋你的筆記並與 Agenda 互動。舉例來說，只要請 Siri 在 Agenda 中搜尋某項內容，你就能直接預覽結果。Siri 也支援 Agenda 與其他應用程式之間更豐富的資料交換。

控制中心

在 iOS 上，Agenda 提供控制中心按鈕，讓你快速跳到「今天」或「在議程上」概覽，而不必先開啟應用程式。你可以在裝置的控制中心設定中加入這些按鈕。

x-callback-url 支援

Agenda 也支援 x-callback 網址。這些讓你能在應用程式之間串接工作流程，以及／或自動化 Agenda 內的某些動作。Apple 的「捷徑」應用程式同樣支援它。

x-callback-url 快速入門：

URL scheme 為 agenda 或 agenda-notes
目前的指令包括 on-the-agenda、today、open-project 等
對於「open-project」和「open-note」，你可以使用 title 參數指定目標。
一如慣例，你可以透過選用的 x-success 和 x-error 參數提供回呼網址。

舉例來說，若要開啟 Agenda 並前往一則名為「Meeting With Peta」的筆記，你可以使用這個網址： agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Agenda 23 新功能： move-note 動作讓你能從另一個應用程式或捷徑，將筆記在專案之間移動： agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

MCP（Model Context Protocol）整合

Agenda 在 macOS 上內建一個 MCP 伺服器，讓 AI 助理能與你的筆記、專案和類別互動。MCP 是一個開放協定，Claude Code、Claude Desktop、Cursor 和 Codex 等工具都用它來與應用程式溝通。

啟用 MCP 伺服器

MCP 伺服器預設為關閉。若要啟用它，請前往 Agenda 選單並選擇整合 > 啟用 MCP。伺服器會在你的 Mac 本機上以 http://127.0.0.1:16106/mcp 執行，且僅能從你自己的機器存取。

「整合」選單也提供選項，可複製用於連接各種 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 伺服器，請使用「整合」選單中的設定指令，或手動設定：

Claude Code：

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

Claude Desktop / Cursor： 在你的 MCP 設定中，使用 npx mcp-remote http://localhost:16106/mcp 作為指令。或者，也可以直接從「整合」選單安裝 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 工具連接完成，它就能依你的要求讀取和修改你的筆記。以下是一些效果不錯的範例：

「把我這星期的會議筆記摘要成一則新筆記，放進『每週回顧』專案。」
「找出任何標記為 #followup 且提到 Anna 的內容並列出來。」
「把這份 PDF 中的待辦事項加到我的『專案啟動』筆記底部。」（AI 也可以附加檔案）
「把『Q2 規劃』筆記從『草稿』移到『策略』專案。」
「建立一個名為『假期』的新專案，並在裡面放一份打包清單。」
「從我的『三月帳單』筆記中取出發票 PDF，告訴我總金額。」

由於 MCP 伺服器在你的 Mac 本機上執行，你的筆記在前往 AI 工具的途中絕不會離開你的機器——只有助理讀取或寫入的特定文字會經由它傳送。

疑難排解

如果你的 AI 工具看不到 Agenda：

MCP 已啟用了嗎？ 請檢查 Agenda > 整合 > 啟用 MCP。當伺服器執行中時，該選單項目會變成 停用 MCP。
Agenda 正在執行嗎？ 伺服器存在於 Agenda 應用程式內部——如果 Agenda 結束，伺服器也會隨之停止。
AI 工具在你啟用 MCP 之後重新連線了嗎？ 有些用戶端會在啟動時快取連線。如果 AI 工具在你啟用 MCP 之前就已在執行，請重新啟動它。
連接埠 16106 被其他程式占用了嗎？ 從「終端機」快速測試一下：curl http://127.0.0.1:16106/mcp 應該會傳回一個回應（而不是「connection refused」）。

注意： MCP 伺服器僅在 macOS 上提供。