Google People
Generally AvailableWith OAuth2 authorization, an AI agent can search contacts, read profile details, and create or update contact records on your behalf.
- Contacts
- Google Workspace
- Directory
- Authentication
- OAuth 2.0
- Hosting
- Vendor-hosted endpoint
- Required scopes
- 3
- Data actions
- Read only
How it works
Every agent request passes through Ferentin policy before it reaches Google People.
- AI agentAsks for something
- Ferentin policies
- OAuth 2.0 consent
- Granular scope selection
- Audit logging
- Google People MCP serverAuthorized connection
- Governed resultMasked, logged, returned
What agents can do
3 tools · you choose which ones agents may callSearch and browse what exists, without opening the content itself.
- search_directory_people
- search_contacts
Permissions requested
The OAuth 2.0 scopes Google People asks you to approve when you connect.
| Scope | Access |
|---|---|
| https://www.googleapis.com/auth/directory.readonly | Read |
| https://www.googleapis.com/auth/userinfo.profile | Not rated |
| https://www.googleapis.com/auth/contacts.readonly | Read |
Before you connect
- Google does not support Dynamic Client Registration (DCR) — each tenant must create its own OAuth client in Google Cloud Console.
- Use access_type=offline to receive a refresh token for long-lived access.
- The People API must be enabled on the same Google Cloud project as the OAuth client.
About Google People
Google Contacts (the People API) stores and manages contact records and profile details across Google Workspace and personal accounts.
Frequently asked about Google People
- What can AI agents do with Google People through Ferentin?
- Ferentin exposes 3 Google People MCP tools to your AI agents, grouped as Discover (2 tools) and Access (1 tool). Every call is checked against your Ferentin policies before it reaches Google People.
- How is Google People access secured?
- Requests through the Google People integration are covered by OAuth 2.0 consent, granular scope selection and audit logging. These controls are applied by Ferentin, not by Google People, so they hold across every connected agent.
- What permissions does the Google People integration require?
- The Google People integration requests 3 OAuth 2.0 scopes: https://www.googleapis.com/auth/directory.readonly (read access); https://www.googleapis.com/auth/userinfo.profile; https://www.googleapis.com/auth/contacts.readonly (read access)
- How do I connect Google People to Ferentin?
- Open the Ferentin admin console, add Google People as a new connection and authenticate with OAuth 2.0. You then choose which permissions and which tools your agents may use, and the connection goes live for everyone covered by your policies.
- Is the Google People integration generally available?
- Yes. The Google People integration is generally available on Ferentin, including the free tier.
Related integrations
4
Google Gmail
Read, search, draft, and send email so your agent can triage and act on your inbox.
Google Calendar
Calendar event management via Google Calendar. View availability, create and update events, schedule meetings.
Salesforce
CRM platform with full SObject CRUD, SOQL/SOSL queries, schema discovery, and relationship traversal — all governed by org security model.
HubSpot
CRM, marketing, sales, and service via HubSpot. Manage contacts, companies, deals, and tickets through OAuth2 authorization.