Hosting

Google-managed remote

Transport

Streamable HTTP

Endpoint

https://people.googleapis.com/mcp/v1

Authentication

OAuth 2.0. Configure the consent screen and an OAuth client marked “Use this client for an AI-powered agent”; grant only the listed product scopes and sign in with the Google account that should be accessible.

Requirements

• Membership in the Google Workspace Developer Preview Program.
• A Google Cloud project, with the relevant Workspace API and its MCP service enabled.
• A supported remote MCP client and a Google account with access to the target Workspace data.
• OAuth 2.0 consent configuration with these scopes: https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly.
• OAuth scope https://www.googleapis.com/auth/contacts.readonly for contact lookup.
• OAuth scope https://www.googleapis.com/auth/directory.readonly for Workspace directory lookup.
• OAuth scope https://www.googleapis.com/auth/userinfo.profile for profile lookup.

Setup steps

1. Join the Google Workspace Developer Preview Program and select/create a Google Cloud project.
2. Enable People API and the matching MCP service in that project.
3. Configure Google Auth Platform consent and add the scopes shown in Requirements.
4. Create an OAuth 2.0 client for an AI agent; use the redirect URI required by your MCP client.
5. Add this server URL to the client: https://people.googleapis.com/mcp/v1
6. Authenticate with the intended Google account, grant the requested scopes, refresh the tool list, and verify the listed operations.

Corrected catalog collision: this People API MCP exposes only its three People tools; previously listed Gmail, Drive, Docs, Sheets, Slides, Calendar, Chat and Classroom tools belong to separate services. Developer Preview; contact and directory results contain personal data.

• get_user_profile

  Retrieves the authenticated user’s Google Workspace profile information.

  01
• search_contacts

  Searches the authenticated user’s contacts by query and returns matching contact names and email addresses.

  02
• search_directory_people

  Searches people in the Google Workspace directory, subject to granted permissions.

  03

This server’s available tools can vary by account, permissions, or configuration. The list shown is not its full runtime catalog.

• Developer Preview; requires Workspace Developer Preview enrollment and OAuth consent/scopes.

• official tool reference

  Google People API reference documents exactly three tools: get_user_profile, search_contacts and search_directory_people.

• official setup documentation

  Documents preview enrollment, OAuth setup and security requirements.

Documentation checked 2026-10-28T00:00:00Z. Connection has not been runtime tested.