インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Google Contacts をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
AI に Google Contacts で作業させます。メールアドレス、電話番号、会社、住所を含む連絡先の検索と閲覧、連絡先の作成と更新、ラベルの整理、メールを送ったものの保存していない相手の検索ができます。個人の Google アカウントと Google Workspace に対応しています。
こう聞いてみよう
Google Contacts のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Google Contacts をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Google Contacts + ChatGPT
AI に Google Contacts で作業させます。メールアドレス、電話番号、会社、住所を含む連絡先の検索と閲覧、連絡先の作成と更新、ラベルの整理、メールを送ったものの保存していない相手の検索ができます。個人の Google アカウントと Google Workspace に対応しています。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET
ステップ 1 — 認証情報を取得
- console.cloud.google.com を開き、プロジェクトを選択または作成してから、APIs & Services → Library で Google People API を有効にします。
- APIs & Services → OAuth consent screen を開きます。Google Workspace を使っている場合は Internal（最も簡単です）、それ以外は External を選びます。External の場合は公開ステータスを In production にしてください。アプリが Testing のままだと、Google は 7 日後にリフレッシュトークンを取り消し、コネクターは毎週動かなくなります。自分のアカウントで使うだけなら、「unverified app」の警告はそのまま先に進んで構いません。
- APIs & Services → Credentials → Create credentials → OAuth client ID を開き、アプリケーションの種類に Web application を選んで、承認済みのリダイレクト URI に
https://cloud.anythingmcp.com/api/mcp-oauth/callbackを追加します。AnythingMCP をセルフホストしている場合は、代わりにhttps://your-anythingmcp-host/api/mcp-oauth/callbackを入力します。 - クライアント ID を
GOOGLE_CLIENT_IDに、クライアントシークレットをGOOGLE_CLIENT_SECRETに貼り付けて、コネクターをインストールします。 - コネクターのページで Authorize with Provider をクリックし、AI に使わせたい連絡先の Google アカウントでサインインします。リフレッシュトークンは暗号化して保存され、アクセストークンは自動的に更新されます。
すべての Google コネクターに 1 つの Google クライアント: 同じ Cloud プロジェクトと OAuth クライアントで、Gmail、Google Calendar、Google Drive、Google Sheets、Google Docs、Google Slides、Google Forms、Google Contacts、Google Meet、Google Tasks、Search Console、Analytics、Ads のすべての Google コネクターを使えます。そのプロジェクトで各 API を有効にし、同じクライアント ID とシークレットを使い回して、コネクターごとに一度ずつ承認してください。各コネクターは自分に必要な権限だけを求めます。
対象範囲: 保存済みの Google 連絡先とそのラベル、そしてメールを送ったものの保存していない相手として Google が記録する「その他の連絡先」です。コネクターは、承認した Google アカウントとして動作します。Google Workspace の組織のディレクトリは含まれません。
検索の準備（ウォームアップ）: Google の連絡先検索はキャッシュを使っています。AI はセッションの最初に google_contacts_warm_up_search で一度キャッシュを更新し、数秒待ってから検索します。検索は名前、メールアドレス、電話番号、会社名の先頭部分に一致します（例: ana、acme）。数分前に作った連絡先が見つからない場合、AI はもう一度ウォームアップするか、最近変更された連絡先を一覧にします。
連絡先の追加と更新: Google は重複を防がないため、AI は連絡先を作る前に検索します。更新では指定した項目がまるごと置き換わります。2 つ目の電話番号を追加するときは、AI が既存の番号と新しい番号をまとめて送ります。変更は 1 件ずつ順番に送られ、一覧や検索に反映されるまで数分かかることがあります。
ラベルとその他の連絡先: AI はラベルを作成し、連絡先を追加したり外したりできます。ラベルから外しても連絡先自体は残ります。「その他の連絡先」は、名前、メールアドレス、電話番号ごと連絡先に保存できます。
権限: コネクターは https://www.googleapis.com/auth/contacts（連絡先とラベルの閲覧と編集）と https://www.googleapis.com/auth/contacts.other.readonly（「その他の連絡先」の閲覧）を求めます。どちらも機密性の高いスコープで、自分の Workspace 組織の外では、アプリが確認されるまで Google が「unverified app」の警告を表示します。自分のアカウントで使うだけなら、そのまま先に進んで構いません。
読み取り専用の設定: コネクターの OAuth 設定でスコープを https://www.googleapis.com/auth/contacts.readonly https://www.googleapis.com/auth/contacts.other.readonly に変更し、もう一度承認してから、google_contacts_create_contact、google_contacts_update_contact、google_contacts_create_contact_group、google_contacts_modify_group_members、google_contacts_save_other_contact を無効にします。「その他の連絡先」を使わない場合は 2 つ目のスコープを外し、google_contacts_list_other_contacts、google_contacts_search_other_contacts、google_contacts_save_other_contact を無効にします。
インストール時はオフ: google_contacts_delete_contact。API では削除した連絡先を元に戻せないため、AI に連絡先を削除させたい場合だけオンにしてください。
変更は承認後に実行: AI は変更のたびに、対象の連絡先と変更内容を示し、あなたの確認を待ちます。連絡先はすぐにスマートフォンや Gmail と同期されます。
よくあるエラー: 401 は承認の期限切れまたは取り消しを示します（同意画面が Testing のままだと 7 日後に必ず起きます）。もう一度 Authorize with Provider をクリックしてください。403 PERMISSION_DENIED は、スコープがその操作を許可していないことを示します。たとえば読み取り専用の設定のときや、「その他の連絡先」のスコープがないときです。403「People API has not been used in project」は、Cloud プロジェクトで Google People API が有効になっていないことを示します。404 は、連絡先の ID が間違っているか、連絡先が削除されたことを示します。更新時の 400 failedPrecondition は、その間に連絡先が変更されたことを示します。AI は連絡先を読み直して再試行します。
このコネクターは Google Workspace のディレクトリを読み取らず、連絡先の写真のアップロードや重複の統合も行いません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — ChatGPT にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
ChatGPT では、Web 版の Plugins ページから MCP サーバーをプラグインとして追加します。有料プランで利用でき、開発者モードはもう必要ありません。Business ワークスペースで追加できるのは管理者とオーナーだけです。Enterprise・Edu では、管理者が Create plugins with MCPs 権限を付与できます。
- chatgpt.com/plugins を開き、+ をクリックして Add custom MCP server を選びます。
- 名前を入力します（例: Name:
Google Contacts）。 - Connection の Server URL に
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Authentication は OAuth のままにします。 - I understand and want to continue を選び、Create as a plugin をクリックします。ChatGPT に求められたら AnythingMCP にサインインし、アクセスを許可します。
- 個人用プラグインから新しいプラグインをインストールし、チャットで @ を入力して選択します。
利用可能なツール
| Tool | What it does |
|---|---|
google_contacts_list_contacts | List the user's saved Google Contacts with the fields asked for (names, emails, phones and organizations by default): resourceName, etag… |
google_contacts_get_contact | Read one contact in full: names, emails, phones, organizations, addresses, birthday, notes, websites, relations, events, group memberships… |
google_contacts_search_contacts | Search the user's saved contacts by the start of a name, nickname, email address, phone number or organization, e.g. "ana" or "acme" |
google_contacts_warm_up_search | Refresh the cache behind contact search with the empty request Google asks for, so the next search sees recent changes |
google_contacts_create_contact | Create a contact in the user's Google Contacts (My Contacts) |
google_contacts_update_contact | Change a contact. update_person_fields lists the fields to change, and each listed field is replaced as a whole: to add a second phone… |
google_contacts_delete_contact | Delete a contact from the user's Google Contacts; it disappears from their phone and Gmail too |
google_contacts_list_contact_groups | List the user's contact groups (labels) and the system groups: resourceName, name, formattedName, groupType (USER_CONTACT_GROUP or… |
google_contacts_get_contact_group | Read a contact group (label) with the resourceNames of its members (memberResourceNames), up to max_members |
google_contacts_create_contact_group | Create a contact group (label) with a name |
google_contacts_modify_group_members | Add contacts to a label or remove them from it (up to 1,000 together) |
google_contacts_list_other_contacts | List the user's "Other contacts": people Google saved automatically because the user emailed them, which are not in My Contacts |
google_contacts_search_other_contacts | Search the user's "Other contacts" (people they emailed but never saved) by the start of a name, email address or phone number |
google_contacts_save_other_contact | Save an "Other contact" into My Contacts, copying its name, email addresses and phone numbers |
プロンプトの例
- 「Ana García さんの携帯番号と、どの会社の人かを教えて。」
- 「Acme GmbH の Marco Rossi さんを連絡先に追加して。[email protected]、+49 761 1234567。」
- 「acme.example の人で、メールは送ったけれど保存していない人を探して、連絡先に保存して。」
- 「「展示会 2026」というラベルを作って、Acme と Globex の人を全員追加して。」
- 「Lukas Weber さんの携帯番号が +49 170 5551234 に変わったので、古い番号は残したまま追加して。」
FAQ
ChatGPT の無料プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランだけで、Free プランは対象に含まれていません。
次のステップ
このガイドは役に立ちましたか?
