Google Contacts

io.github.domdomegg由 GitHub 帳號 domdomegg 發布v1.3.0更新於 Oct 24, 2026

Allow AI systems to list, search, and manage contacts via Google Contacts.

已驗證STDIO僅桌面效率與工作流溝通與協作

概覽

AI 產生的概覽

一個本機 MCP 伺服器，讓助理列出、搜尋、建立、更新和刪除 Google 聯絡人，包括相片和聯絡人分組。

可以做什麼
依姓名、電子郵件或電話列出和搜尋聯絡人，並在組織目錄中尋找同事；讀取單一聯絡人的完整詳細資料，包括電子郵件、電話、組織、生日、地址和自訂欄位；建立、更新和永久刪除聯絡人，設定或移除聯絡人相片；列出、建立、重新命名和刪除聯絡人分組，並新增或移除成員。
適用情境
適合在助理起草訊息時需要查詢某人的電子郵件或電話、從名片或社交活動建立新聯絡人、依公司或城市搜尋個人人脈，或在某人換工作後更新聯絡人資料的情境。
執行需求
透過 npx 在本機執行（需要 Node.js）。需要 Google OAuth 憑證：GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET，並在 Google Cloud 專案中啟用 People API、將重新導向 URI 設為本機回呼。必須設定 MCP_TRANSPORT；README 預設以 HTTP 伺服器執行於 localhost:3000（PORT 可調整）。GOOGLE_ACCESS_TOKEN 也被宣告為必要密鑰。僅限桌面端。
安裝前請注意
它可以建立、更新和永久刪除聯絡人、相片和聯絡人分組，誤操作會造成無法復原的刪除。它需要處理 Google OAuth 密鑰（GOOGLE_CLIENT_SECRET、GOOGLE_ACCESS_TOKEN），並作為 OAuth 代理連線 Google，這些憑證可存取你 Google 帳號中的聯絡人。聯絡人資料會傳送到 Google 的 People API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Google Contacts，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

google-contacts-mcp

MCP server for Google Contacts - list, search, and manage contacts.

Use Cases

Email lookup: "See the latest JIRA ticket that's come in. Can we email Sarah from the security team to get their input?" → finds Sarah's email and drafts the message.

Business card capture: After a networking event, snap photos of business cards → your assistant extracts the details and adds them as contacts with a note about where you met.

Find connections: "Who do I know at Google?" or "I'm visiting London next week - who should I catch up with?" → search your personal network.

Call reminder: "Remind me to call Mike at 3pm" → creates a calendar event with Mike's phone number attached so you can dial straight from the reminder.

Contact updates: You receive an out-of-office saying someone left their company with a new personal email → your assistant updates their contact automatically.

(These are just examples - any workflow that needs contact lookup or management can use this.)

Setup

1. Create Google OAuth credentials

  1. Go to Google Cloud Console
  2. Create a new project (or use existing)
  3. Enable the People API
  4. Go to APIs & Services → OAuth consent screen, set up consent screen
  5. Go to APIs & Services → Credentials → Create Credentials → OAuth client ID
  6. Choose Web application
  7. Add http://localhost:3000/callback to Authorized redirect URIs
  8. Note your Client ID and Client Secret

2. Run the server

bash
GOOGLE_CLIENT_ID='your-client-id' \GOOGLE_CLIENT_SECRET='your-client-secret' \MCP_TRANSPORT=http \npm start

The server runs on http://localhost:3000 by default. Change with PORT=3001.

3. Add to your MCP client

With the server running, follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).

Architecture

This server acts as an OAuth proxy to Google:

mermaid
graph LR    A[MCP client] <--> B[google-contacts-mcp] <--> C[Google OAuth/API]
  1. Server advertises itself as an OAuth authorization server via /.well-known/oauth-authorization-server
  2. /register returns the Google OAuth client credentials
  3. /authorize redirects to Google, encoding the client's callback URL in state
  4. /callback receives the code from Google and forwards to the client's callback
  5. /token proxies token requests to Google, injecting client credentials
  6. /mcp handles MCP requests, using the bearer token to call People API

The server holds no tokens or state - it just proxies OAuth to Google.

Tools

ToolDescription
contacts_listList contacts with names, emails, phones, organizations, birthdays, events, URLs, addresses, nicknames, relations, IM usernames, genders, external IDs, client data, and custom fields
contacts_searchSearch contacts by name, email, or phone
directory_searchSearch organization directory for coworkers
contact_getGet detailed info for a single contact
contact_createCreate a new contact
contact_updateUpdate an existing contact
contact_deletePermanently delete a contact
contact_photo_updateSet or replace a contact's photo
contact_photo_deleteRemove a contact's photo
contact_groups_listList contact groups (labels)
contact_group_getGet a contact group, including its members
contact_group_createCreate a new contact group
contact_group_updateRename a contact group
contact_group_deletePermanently delete a contact group
contact_group_members_modifyAdd or remove contacts from a contact group

Contributing

Pull requests are welcomed on GitHub! To get started:

  1. Install Git and Node.js
  2. Clone the repository
  3. Install dependencies with npm install
  4. Run npm run test to run tests
  5. Build with npm run build

Releases

Versions follow the semantic versioning spec.

To release:

  1. Use npm version <major | minor | patch> to bump the version
  2. Run git push --follow-tags to push with tags
  3. Wait for GitHub Actions to publish to the NPM registry.

來源：README.md，提交 80591d6

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.3.0最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。