Agendaの自動化

Agendaを自動化することで強力なワークフローを作成できます。たとえばSiriショートカットやショートカットAppを使った高レベルの方法でも、x-callback-urlのサポートを通じた低レベルの方法でも可能です。可能性は無限です!

Appショートカット

Agenda 15以降、AppショートカットはショートカットAppを通じてAgendaで1つまたは複数の作業をすばやく行う手段です。複数のAgendaショートカットを組み合わせ、必要に応じてほかのアプリのショートカットも組み合わせることで、独自のワークフローを作成し自動化できます。iPadのホーム画面から特定のノートを開くという単純なものや、iPhoneの背面をダブルタップして新規ノートを起動するものから、今日やるべきことをさまざまなアプリから集めてワンタップで新しいプロジェクトを作成する複雑なワークフローまで、幅広く対応します。

iOS版Agendaは、特定のノート、プロジェクト、概要を開くといった一般的な操作のためのSiriショートカットにも対応しています。

ショートカットでノートを検索する

ショートカットAppの「ノートを検索」アクションを使って、特定の条件に一致するノートを見つけられます。これはx-callback-url経由でも利用できます。検索クエリは\color、\done、\pinnedなどのアクション構文に対応しており、自動化の中でもアプリ内検索と同じ力を発揮します。

Siri

Siriを使ってノートを検索したり、Agendaを操作したりできます。たとえば、Agenda内で何かを検索するようSiriに頼めば、その結果を直接プレビューできます。Siriは、Agendaとほかのアプリとの間でより豊かなデータのやり取りにも対応しています。

コントロールセンター

iOSでは、Agendaはコントロールセンターのボタンを提供しており、先にアプリを開かなくても「今日」や「議題」の概要にすばやくジャンプできます。これらのボタンは、デバイスのコントロールセンター設定で追加できます。

x-callback-urlのサポート

Agendaはx-callback URLにも対応しています。これにより、アプリ間でワークフローを連携させたり、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を指定できます。

たとえば、「Meeting With Peta」というノートをAgendaで開くには、次のURLを使用できます: 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には、AIアシスタントがノート、プロジェクト、カテゴリーとやり取りできるようにする、macOS上の組み込みMCPサーバが含まれています。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 — 特定のノートの全内容を取得します
list_projects — すべてのプロジェクトを一覧表示します。アーカイブ済みのものを含めることもできます
list_categories — すべてのカテゴリーを一覧表示します
open_note — 特定のノートをAgendaで開きます
create_note — プロジェクト内に新規ノートを作成します。ファイルアタッチメントを付けることもできます
append_to_note — 既存のノートに内容やファイルアタッチメントを追加します
edit_note — 既存のノートの内容を変更します。ファイルアタッチメントを付けることもできます
create_project — 新規プロジェクトを作成します
create_category — 新規カテゴリーを作成します
move_note — 既存のノートを別のプロジェクトに移動します (Agenda 23の新機能)

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上のファイルを読み取り、エンコードして、1つのステップでノートに添付できます。たとえば、AIアシスタントに「このPDFを会議メモに添付して」と頼めば、あとは処理してくれます。

各アタッチメントには、filename(Agendaがファイルの種類を判別できるよう拡張子付き)とbase64エンコードされたファイルdataが必要です。オプションで、displayStyle(inline、thumbnail、thumbnail-with-details、full-width)とdisplaySize(small、medium、large)を使ってアタッチメントの表示方法を制御できます。

制限: 1リクエストあたり最大20個のアタッチメント、ファイルデータの合計は最大100 MBです。

ヘルプリソース

MCPサーバは、Agendaのドキュメントから一般的なトピックを扱うヘルプリソースも公開しています。そのため、AIアシスタントは機能の仕組みを調べて、Agendaについてより良い回答を提供できます。

何を頼めるか

AIツールを接続すると、要求に応じてノートを読んだり変更したりできるようになります。うまく機能する例をいくつか挙げます:

「今週の会議メモを要約して、Weekly Reviewsプロジェクトに新しいノートとしてまとめて。」
「#followupタグが付いていてAnnaに言及しているものを探して一覧にして。」
「このPDFのアクション項目を、Project Kickoffノートの末尾に追加して。」 (AIはファイルを添付することもできます)
「『Q2 Planning』のノートをDraftsからStrategyプロジェクトに移動して。」
「Holidayという新しいプロジェクトを作って、荷造りリストを入れておいて。」

MCPサーバはMac上でローカルに動作するため、AIツールに向かう途中でノートがマシンの外に出ることはありません。アシスタントが読み書きする特定のテキストだけがそこを通ります。

トラブルシューティング

AIツールからAgendaが見えない場合:

MCPは有効ですか? Agenda > 統合機能 > MCPを有効にするを確認します。サーバが動作しているときは、メニュー項目がMCPを無効にするに変わります。
Agendaは起動していますか? サーバはAgendaアプリの内部で動作します。Agendaを終了すると、サーバも一緒に停止します。
MCPを有効にした後、AIツールは再接続しましたか? 一部のクライアントは起動時に接続をキャッシュします。MCPを有効にする前からAIツールが起動していた場合は、再起動してください。
ポート16106がほかの何かに使われていませんか? ターミナルからの簡単なテスト: curl http://127.0.0.1:16106/mcpが(「connection refused」ではなく)レスポンスを返すはずです。

注意: MCPサーバはmacOSでのみ利用できます。