Chronary

@chronary/mcp

Chronary 用 MCP サーバー — AI アシスタント向けのカレンダーツールです。

50 個のカレンダーツール（エージェント、カレンダー、イベントの管理、人による Google/Microsoft のセットアップ依頼、会議時間の検索、スケジュールの提案の実行、空き時間ルールの設定、Webhook、iCal サブスクリプション、スコープ付きキー、監査ログ、使用状況の管理）を、MCP 対応クライアント（Claude Desktop、Cursor、VS Code Copilot、Claude Code、Windsurf）にまとめて追加できます。

Smithery からワンクリックでインストール： npx -y @smithery/cli mcp add chronary/agent-calendar --client claude（--client を cursor、vscode、claude-code、windsurf などに置き換えてください）。

前提条件

1. Chronary アカウント — chronary.ai で登録してください。
2. コンソールで取得した API キー（chr_sk_ で始まります）。
3. MCP クライアントを実行するマシン上の Node.js ≥ 18。

クライアントの設定

すべての例では npx -y @chronary/mcp を使用します。これにより、最新バージョンが必要に応じてダウンロードされ、実行されます。インストール手順は不要です。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

macOS / Linux：

{
  "mcpServers": {
    "chronary": {
      "command": "npx",
      "args": ["-y", "@chronary/mcp"],
      "env": {
        "CHRONARY_API_KEY": "chr_sk_..."
      }
    }
  }
}

Windows（spawn では npx.cmd を直接解決できないため、cmd /c を使用します）：

{
  "mcpServers": {
    "chronary": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chronary/mcp"],
      "env": {
        "CHRONARY_API_KEY": "chr_sk_..."
      }
    }
  }
}

保存した後、Claude Desktop を再起動してください。

Cursor

.cursor/mcp.json（プロジェクトレベル）または ~/.cursor/mcp.json（ユーザーレベル）を編集します。

macOS / Linux：

{
  "mcpServers": {
    "chronary": {
      "command": "npx",
      "args": ["-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Windows：

{
  "mcpServers": {
    "chronary": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

VS Code Copilot

.vscode/mcp.json（ワークスペース）を編集するか、MCP: Open User Configuration コマンドを実行してユーザーレベルの設定を行います。VS Code ではトップレベルキーに別のキー（servers）を使用し、明示的な type が必要です。

macOS / Linux：

{
  "servers": {
    "chronary": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Windows：

{
  "servers": {
    "chronary": {
      "type": "stdio",
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Claude Code

プロジェクトのルートにある .mcp.json、またはユーザーレベルの ~/.claude.json を編集します。

macOS / Linux：

{
  "mcpServers": {
    "chronary": {
      "command": "npx",
      "args": ["-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Windows：

{
  "mcpServers": {
    "chronary": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json（Windows では %USERPROFILE%\.codeium\windsurf\mcp_config.json）を編集します。

macOS / Linux：

{
  "mcpServers": {
    "chronary": {
      "command": "npx",
      "args": ["-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Windows：

{
  "mcpServers": {
    "chronary": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Windsurf の制限： Cascade では、すべての MCP サーバーを合わせてツール数が 100 個まで、プロンプトあたりのツール呼び出し数が 20 回までに制限されています。Chronary は 50 個のツールを公開します。複数のサーバーを併用する場合は、--tools によるフィルタリングを検討してください。

--tools でコンテキストを削減する

50 個すべてのツールを公開すると、リクエストのたびに LLM トークンを消費します。用途を絞ったワークフローでは、必要なツールだけを許可リストに指定してください。

{
  "mcpServers": {
    "chronary": {
      "command": "npx",
      "args": [
        "-y", "@chronary/mcp",
        "--tools", "list_events,find_meeting_time,create_event"
      ],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

本番環境以外の API を指定する

セルフホストの Chronary インスタンス、またはローカル API を使用した開発の場合：

{
  "args": ["-y", "@chronary/mcp", "--base-url", "http://localhost:8787"]
}

公開されているツール

ツール	読み取り専用	破壊的
list_calendars, get_calendar	✓
create_calendar, update_calendar
delete_calendar		✓
list_events, get_event	✓
create_event, update_event, confirm_event
cancel_event, release_event		✓
list_agents, get_agent	✓
create_agent, update_agent
delete_agent		✓
get_availability, find_meeting_time	✓
get_calendar_context	✓
list_proposals, get_proposal	✓
create_proposal, respond_to_proposal, resolve_proposal
cancel_proposal		✓
get_availability_rules	✓
set_availability_rules
clear_availability_rules		✓
list_webhooks, get_webhook, list_webhook_deliveries	✓
create_webhook, update_webhook
delete_webhook		✓
list_ical_subscriptions, get_ical_subscription	✓
subscribe_ical, update_ical_subscription, sync_ical_subscription
delete_ical_subscription		✓
list_scoped_keys	✓
create_scoped_key
revoke_scoped_key		✓
get_audit_log	✓
accept_terms
get_usage	✓

ツールのアノテーション（readOnlyHint、destructiveHint、idempotentHint）は MCP クライアントに公開されるため、ホストはユーザーの確認を必須にするかどうかを判断できます。

トラブルシューティング

Windows で「spawn npx ENOENT」が発生する場合 — 上記の cmd /c npx ... 形式を使用してください。

「CHRONARY_API_KEY is required」が表示される場合 — 環境変数のブロックは、設定ファイルの最上位ではなく、サーバーのエントリの下にネストする必要があります。

ツールが表示されない場合 — 設定を編集した後、MCP クライアントを再起動してください。ほとんどのクライアントは起動時にのみ設定を読み込みます。

バイナリがローカルで実行できることを確認するには：

CHRONARY_API_KEY=test npx -y @chronary/mcp --help

リンク

• Chronary のドキュメント
• MCP 仕様
• 問題を報告

ライセンス

Apache-2.0