Google Contacts

🚀 MCP Google Contacts Server

MCP Google Contacts Serverは、Google Contacts APIとやり取りし、あなたの連絡先やGoogle Workspaceディレクトリを管理するための強力なツールです。このサーバーを使用すると、連絡先の作成、更新、削除、その他のcontactsの検索など、様々な操作を実行できます。

🚀 クイックスタート

MCP Google Contacts Serverを使うことで、Google Contacts APIとのやり取りを通じて、連絡先の管理やGoogle Workspaceディレクトリの操作が可能になります。以下に、具体的な機能と使用方法を紹介します。

✨ 主な機能

• 全ての連絡先をリストする：すべてのGoogle Contactsを取得するか、名前でフィルタリングします。
• 特定の連絡先情報を取得する：リソース名またはメールアドレスを使用して詳細情報を取得します。
• 新しい連絡先を作成する：新しい連絡先情報を追加します。
• 既存の連絡先を更新する：既存の連絡先の情報を変更します。
• 連絡先を削除する：指定した連絡先をGoogle Contactsから削除します。
• contactsを検索する：名前、メールアドレス、または電話番号で特定の連絡先を検索します。
• Google Workspaceユーザーをリストする：組織のディレクトリ内のすべてのユーザーを取得します。
• ディレクトリメンバーを検索する：特定のディレクトリメンバーを見つけるためのターゲット検索を実行します。
• その他のcontactsを取得する：Contactsに追加されていないが、やり取りしたことのある人を取得します。

📚 ドキュメント

詳細ツール説明

list_contacts

すべてのGoogle連絡先をリストするか、名前でフィルタリングします。

パラメータ：

• name_filter（オプション）：名前で連絡先をフィルタリングするための文字列
• max_results（オプション）：返される最大連絡先数。デフォルトは100

例：

list_contacts(name_filter="John", max_results=10)

get_contact

特定の連絡先の詳細情報を取得します。

パラメータ：

• identifier：リソース名（people/*）またはメールアドレス

例：

get_contact("john.doe@example.com")
# または
get_contact("people/c12345678901234567")

create_contact

新しいGoogle連絡先を作成します。

パラメータ：

• given_name：連絡先の姓
• family_name（オプション）：連絡先の名
• email（オプション）：メールアドレス
• phone（オプション）：電話番号

例：

create_contact(given_name="Jane", family_name="Smith", email="jane.smith@example.com", phone="+1-555-123-4567")

update_contact

既存の連絡先の情報を更新します。

パラメータ：

• resource_name：連絡先のリソース名（people/*）
• given_name（オプション）：更新する姓
• family_name（オプション）：更新する名
• email（オプション）：更新するメールアドレス
• phone（オプション）：更新する電話番号

例：

update_contact(resource_name="people/c12345678901234567", email="new.email@example.com")

delete_contact

指定した連絡先を削除します。

パラメータ：

• resource_name：削除する連絡先のリソース名（people/*）

例：

delete_contact(resource_name="people/c12345678901234567")

search_contacts

名前、メールアドレス、または電話番号でcontactsを検索します。

パラメータ：

• query：検索に使用するクエリ文字列
• max_results（オプション）：返される最大結果数。デフォルトは10

例：

search_contacts(query="john", max_results=5)

list_workspace_users

組織のディレクトリ内のすべてのGoogle Workspaceユーザーをリストします。

パラメータ：

• query（オプション）：特定のユーザーを見つけるためのクエリ文字列
• max_results（オプション）：返される最大結果数。デフォルトは50

例：

list_workspace_users(query="engineering", max_results=25)

search_directory

特定のディレクトリメンバーを見つけるためのターゲット検索を実行します。

パラメータ：

• query：検索に使用するクエリ文字列
• max_results（オプション）：返される最大結果数。デフォルトは10

例：

search_directory(query="Marketing", max_results=20)

get_other_contacts

Contactsに追加されていないが、やり取りしたことのある人を取得します。

パラメータ：

なし

例：

get_other_contacts()

権限説明

このサーバーを使用するには、以下の権限が必要です。

• Google連絡先の読み取りと書き込み
• Google Workspaceディレクトリの管理

APIキーが適切な権限を持っていることを確認してください。

トラブルシューティングガイド

よくある質問と回答

1. APIキーをどのように取得できますか？
   • Google Cloud ConsoleでAPIキーを見つけ、新しいAPIキーを生成できます。
2. 権限エラーが発生した場合はどうすればいいですか？
   • APIキーが必要な権限を持っていることを確認してください。Google連絡先APIとGoogle WorkspaceディレクトリAPIを有効にする必要がある場合があります。
3. サーバーに接続できません。
   • ネットワーク接続を確認し、ファイアウォールがGoogleサービスとの通信をブロックしていないことを確認してください。
4. 404エラーをどのように解決できますか？
   • 提供したリソース名またはメールアドレスが正しく、形式が正しいことを確認してください。

📄 ライセンス

このプロジェクトはMITライセンスに従います。コミュニティからの貢献を歓迎しますが、コード規約を遵守し、詳細なコミット情報を提供するようにしてください。

貢献するには、GitHubリポジトリを訪問してください：MCP Google Contacts Server

関連リンク

• Google連絡先APIドキュメント
• Google WorkspaceディレクトリAPIドキュメント