Google Contacts

一個基於MCP協議的Google聯繫人服務，提供聯繫人管理、組織目錄搜索和Google Workspace交互功能。

通信工具客戶數據平臺 #聯繫人管理 #組織目錄 #Google集成 #MCP服務 .Python

評分 : 2.5分

下載量 : 18

更新時間 : 2025-04-28

什麼是MCP Google Contacts Server?

這是一個基於Machine Conversation Protocol (MCP)的服務器，允許AI助手幫助您管理Google聯繫人、搜索組織目錄，並與Google Workspace進行交互。它提供了聯繫人管理的完整功能集，包括創建、更新、刪除和搜索聯繫人。

如何使用MCP Google Contacts Server?

您可以通過AI助手(如Claude)與服務器交互，發送指令來管理聯繫人。首先需要設置Google API認證，然後啟動服務器，最後通過MCP客戶端連接。

適用場景

當您需要通過AI助手快速查找聯繫人、批量更新聯繫人信息、管理組織目錄或同步工作聯繫人時特別有用。

主要功能

聯繫人管理完整的CRUD功能(創建、讀取、更新、刪除聯繫人)

組織目錄搜索搜索整個Google Workspace組織目錄中的用戶

其他聯繫人訪問查看您互動過但未正式添加的聯繫人

Google Workspace集成與Google Workspace深度集成，訪問組織用戶信息

優勢與侷限性

優勢

通過AI助手自然語言交互管理聯繫人

無需直接操作Google Contacts界面

可以批量處理聯繫人操作

支持組織目錄搜索，方便查找同事

侷限性

需要Google API權限設置

受Google People API配額限制

初次使用需要OAuth認證流程

如何使用

安裝準備

確保已安裝Python 3.12+，並準備好Google API憑據

認證設置

配置Google API認證，可以選擇credentials.json文件或環境變量方式

啟動服務器

運行服務器，選擇適合的傳輸協議(stdio或http)

連接AI助手

在AI助手(如Claude)中配置MCP服務器連接

使用案例

查找同事聯繫方式當您需要快速找到某位同事的聯繫方式時

批量更新聯繫人當公司郵箱域名變更需要批量更新聯繫人郵箱時

新員工入職當有新員工加入需要添加到聯繫人時

常見問題

如何獲取Google API憑據?

為什麼我無法搜索組織目錄?

服務器支持哪些AI助手?

有使用限制嗎?

🚀 MCP Google Contacts Server

MCP Google Contacts Server 是一款強大的工具，可與 Google Contacts API 交互，幫助您高效管理聯繫人與 Google Workspace 目錄。藉助該服務器，您能輕鬆執行創建、更新、刪除聯繫人等操作，還可搜索其他聯繫人。

🚀 快速開始

MCP Google Contacts Server 可讓您輕鬆與 Google Contacts API 交互，管理您的聯繫人和 Google Workspace 目錄。使用前，請確保您的 API 密鑰具備相應權限。

✨ 主要特性

列出所有聯繫人：可獲取所有 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 密鑰具有適當的權限。

💡 故障排除指南

常見問題解答

⚠️ 重要提示

若在使用過程中遇到問題，可參考以下常見問題解答。

💡 使用建議

請仔細核對輸入信息，確保 API 密鑰權限正確。

如何獲取我的 API 密鑰？ 您可以在 Google Cloud Console 中找到並生成新的 API 密鑰。
我收到權限錯誤怎麼辦？ 確保您的 API 密鑰具有所需的權限。您可能需要啟用 Google 聯繫人 API 和 Google Workspace 目錄 API。
無法連接到服務器？ 檢查您的網絡連接，確保沒有防火牆阻止與 Google 服務的通信。
如何解決 404 錯誤？ 確保您提供的資源名稱或電子郵件地址是正確的，並且格式正確。

📄 許可證

此項目遵循 MIT 許可證。我們歡迎社區貢獻，但請確保遵守代碼規範並提供詳細的提交信息。

如需貢獻，請訪問我們的 GitHub 倉庫：MCP Google Contacts Server