Appointy MCP Server and API by Cotlet について
AI エージェントをログイン済みの Appointy アカウントに接続し、予約や顧客対応を行う MCP サーバーです。ホスト型接続に加え、Cotlet.dev へ呼び出しを転送するローカル stdio 方式も利用できます。
主な機能
- 01予約の作成と変更
- 02予約のキャンセルと顧客への通知
- 03スタッフ別の予定と空き時間の確認
- 04予約リマインダーの送信
- 05ホスト型とローカル stdio に対応
活用シーン
- 01顧客の相談予約と確認通知
- 02スタッフ別の予定の空き時間確認
- 03予約変更と関係する顧客への通知
MCP 対応
Cotlet.dev のホスト型エンドポイントを通じて、MCP クライアントに Appointy のツールを提供します。ローカル stdio サーバーも利用でき、ツール呼び出しをホスト型サービスへ転送します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://cotlet.dev/mcp/v1/appointy/connectclaude mcp add --transport http dev-cotlet-appointy https://cotlet.dev/mcp/v1/appointy/connect{"mcpServers":{"dev-cotlet-appointy":{"type":"http","url":"https://cotlet.dev/mcp/v1/appointy/connect"}}}Cursor で開く{"servers":{"dev-cotlet-appointy":{"type":"http","url":"https://cotlet.dev/mcp/v1/appointy/connect"}}}VS Code で開く{"mcpServers":{"dev-cotlet-appointy":{"type":"http","url":"https://cotlet.dev/mcp/v1/appointy/connect"}}}{"mcpServers":{"dev-cotlet-appointy":{"serverUrl":"https://cotlet.dev/mcp/v1/appointy/connect"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://cotlet.dev/mcp/v1/appointy/connecthttps://cotlet.dev/mcp/v1/appointy認証が必要ツール
詳細
Appointy を Claude Code、ChatGPT、あらゆる AI エージェントに接続する方法
はい、Claude、ChatGPT、その他の AI エージェントは Appointy アカウントで作業できます。 ChatGPT や Claude のディレクトリには Appointy の公式アプリが見つからず、サードパーティ製の Zapier MCP 統合で利用できるアクションは「顧客を作成」の 1 つだけでした。Cotlet.dev を使うと、サインイン済みのご自身の Appointy アカウントをあらゆる AI エージェントに接続できます。普段の言葉で頼むだけで、AI が予約、日時変更、クライアントへのリマインダー送信を行います。
依頼できること
木曜日の午前 10 時に、Dr. Patel の 60 分間の相談を Maria Lopez に予約して、確認メールを送ってください。
来週月曜日のスタッフごとの予定を教えてください。45 分を超える空き時間があれば一覧にしてください。
Tom の金曜日午後の予約をすべて土曜日午前に移動して、各クライアントに通知してください。
水曜日午後 3 時のグループレッスンをキャンセルして、予約している 8 人に連絡してください。
明日の予約者のうち、まだ確認していない全員にリマインダーを送ってください。
2 分で接続
https://cotlet.dev/app で API キーを取得し、COTLET_API_KEY としてエクスポートします。
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
ChatGPT
「Settings → Apps」からコネクター URL https://cotlet.dev/mcp/v1 を追加し、Cotlet.dev にサインインします。API キーは不要です。
Cursor
このリポジトリの .cursor/mcp.json をプロジェクトにコピーします。
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}
ローカルで実行する(stdio)
このリポジトリは実際の MCP サーバーです。stdio 経由で MCP 通信を行い、API キーなしで Appointy のツールを一覧表示し、すべてのツール呼び出しをホストされた Cotlet.dev サーバーに転送します。上記のホスト URL を使う方法を推奨します。クライアントがローカルサーバーしか起動できない場合に、こちらをお使いください。
{"mcpServers":{"appointy":{"command":"uvx","args":["appointy-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}
Docker を使う場合:
docker build -t appointy-mcp .
docker run -i --rm -e COTLET_API_KEY appointy-mcp
ツール:appointy_guide、appointy_status、appointy_open、appointy_read、appointy_click、appointy_type、appointy_close。COTLET_API_KEY が設定されていない場合、ツール呼び出しには「COTLET_API_KEY を設定してください。キーは https://cotlet.dev/app で取得できます。」と応答します。
コマンドライン
Python 3.10 以降が必要です。ほかにインストールするものはありません。PyPI からインストールする場合:
pip install appointy-mcp # or run it once: uvx appointy-mcp connect
appointy-mcp connect
または、このリポジトリから直接インストールする場合:
export COTLET_API_KEY="your-key"
python3 appointy_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 appointy_agent.py status # is Appointy ready in your Cotlet.dev account
python3 appointy_agent.py guide # Appointy screens and sign-in link
python3 appointy_agent.py read # open Appointy, read the page, close the browser
python3 appointy_agent.py tools # list Cotlet.dev tools
python3 appointy_agent.py serve # start the stdio MCP server (same as no argument)
Appointy ユーザーからの質問
Appointy に API や開発者向けドキュメントはありますか?
Appointy のプライベート API を利用できるのは Enterprise プランのみです。また、Zapier アプリでできるのは顧客の作成だけです。Cotlet.dev はどのプランでも、サインイン済みのご自身の Appointy アカウントで動作するため、AI エージェントで予約、承認、日時変更、キャンセルができます。
Appointy を ChatGPT に接続するにはどうすればよいですか?
ChatGPT のアプリとして Cotlet.dev を追加し(「Settings → Apps」から、コネクター URL https://cotlet.dev/mcp/v1 を入力)、Cotlet.dev の Cloud Browser で一度 Appointy にサインインしてから、普段の言葉で ChatGPT に依頼します。コードも Appointy API キーも必要ありません。
Appointy で Claude を使う方法はありますか?
はい。Claude Code では上記の 1 行の claude mcp add コマンドを実行します。Claude アプリでは https://cotlet.dev/mcp/v1 をカスタムコネクターとして追加します。これで Claude がご自身の Appointy アカウントで動作します。
Appointy 用の MCP サーバーはありますか?
Appointy には公式 MCP サーバーがなく、ChatGPT や Claude の公式アプリもありません(2026 年 11 月時点で確認)。Cotlet.dev は、Claude、ChatGPT、Cursor、Codex、n8n、Make、Zapier と連携し、ご自身のアカウントで動作するホスト型 Appointy MCP サーバーです。
掲載先
こちらとも連携できます
- Mangomint MCP
- Wanderlog MCP
- SmugMug MCP
- Garmin Connect MCP
- Housecall Pro MCP
- Medium MCP
- Crexi MCP
- DistroKid MCP
- LinkedIn MCP
- EstimateOne MCP
- Google Search Console MCP
- Lichess MCP
- Strava MCP
- StreamElements MCP
- Meetup MCP
- AccuRanker MCP
- GetYourGuide MCP
- Idealista MCP
- Riverside MCP
- Udemy MCP
- Faire MCP
- Buildertrend MCP
- Fresha MCP
- Booksy MCP
- BookingKoala MCP
- Milanote MCP
- Partiful MCP
- Contractor Foreman MCP
- Pixieset MCP
- GlossGenius MCP
- ZenMaid MCP
- FieldEdge MCP
- Phorest MCP
- DINGG MCP
- Invoice Simple MCP
- PhotoShelter MCP
- RazorSync MCP
- ShootProof MCP
- Invoice2go MCP
- Contractor+ MCP
- Cotlet.dev を通じて連携できるすべてのアプリ
無料で始める:https://cotlet.dev/signup?app=appointy&utm_source=github&utm_medium=readme&utm_campaign=appointy
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。