mcp-server-agenda

mcp-server-agenda

Claude AI を通じて macOS の Agenda アプリを操作するためのサーバー実装です。このサーバーは、x-callback-url を使用して Agenda でノートを作成したり、プロジェクトを管理したり、既存のノートを開いたりするためのツールを提供します。

機能

• Agenda でさまざまなオプション（タイトル、テキスト、日付、テンプレートなど）を指定してノートを作成
• Agenda 内でプロジェクトを作成および管理
• Claude から既存のノートを直接開く
• Agenda の x-callback-url スキームを完全にサポート

インストール

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/mcp-server-agenda.git
   cd mcp-server-agenda
   

使用方法

X-Callback-URL 連携

このサーバーは、Agenda の x-callback-url スキームを使用してアプリと連携します。サポートされているアクションは次のとおりです：

• create-note
• open-note
• create-project

Agenda の x-callback-url スキームについて詳しくは、ドキュメントをご覧ください。

設定

Claude Desktop の設定

Claude がサーバーと連携できるようにするには、$HOME/Library/Application Support/Claude/claude_desktop_config.json にある Claude デスクトップの設定ファイルに、次の設定を追加します：

{
    "mcp-server-agenda": {
        "command": "uv",
        "args": [
            "--directory",
            "/Users/your.username/git/mcp-server-agenda",
            "run",
            "mcp-server-agenda"
        ]
    }
}

/Users/your.username を実際のホームディレクトリのパスに置き換えてください。

要件

• macOS
• Python 3.7+
• Agenda アプリがインストールされていること
• uv - 最新の Python パッケージインストーラーおよびリゾルバー

  pip install uv
  

• 必要な Python パッケージ（requirements.txt を参照）

プロジェクトのセットアップ

uv を正常に動作させるには、プロジェクトに pyproject.toml ファイルが必要です。ルートディレクトリに作成してください：

[project]
name = "mcp-server-agenda"
version = "0.1.0"
description = "A server implementation for interacting with the Agenda app on macOS through Claude AI"
requires-python = ">=3.7"
dependencies = [
    "flask",
    # Add other dependencies here
]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

pyproject.toml の設定後、次のコマンドでプロジェクトを開発モードでインストールできます：

uv pip install -e .

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

謝辞

• x-callback-url のサポートを提供してくださった Agenda チームに感謝します
• AI を活用したノート管理の必要性から着想を得ました

サポート

サポートが必要な場合は、GitHub リポジトリで issue を作成するか、メンテナーにお問い合わせください。