Connectors · CRM & sales

Google Contacts MCP server for AI agents.

actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Google Contacts and the rest of your systems. It gives your agent 24 Google Contacts actions (11 reads, 9 writes and 4 that wait for a confirmation) and holds the Google Contacts credential itself, so the agent never does. It paces Google Contacts's limits and records every call. Connecting Google Contacts needs your own Google Contacts OAuth app and one admin sign-in.

Connect Google Contacts free See pricing

100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.

claude mcp add --transport http actionlake https://connect.actionlake.com/mcp

24actionsin one signed file
11readlook, never change
9writecreate and update
4wait for a yesdestructive, confirmed first

Set up

Connect Google Contacts in three steps.

01
Add actionlake to Claude.
Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
https://connect.actionlake.com/mcp
02
Connect Google Contacts.
OAuth 2.0, authorization code with PKCE. You register your own OAuth app with Google Contacts, an admin signs in once, and you paste the app's client id and secret and the tokens from that sign-in; actionlake renews the access token from then on. actionlake stores what you paste write-only, sealed under your tenant's key.
Before the first sign-in, Google Contacts needs an OAuth app of your own, registered in its developer portal. actionlake has no Google Contacts app to lend you.
- access_tokenAccess token from one sign-in with your own OAuth app
- refresh_tokenRefresh token from the same sign-in; the access token is renewed from it
- client_idGoogle OAuth client id (Google Cloud console > APIs & Services > Credentials; enable the People API on the project)
- client_secretGoogle OAuth client secret
```
account { op: "connections.requirements", service: "gws_contacts" }
# free: exactly what to paste, and what is found for you
```

Make the first call. Check before a write.

Ask in plain words; Claude picks the action. Before anything changes, check validates the call and prices it, for free.

do    { action: "gws_contacts.contact_groups.list" }# list contact groups (labels) · read · 1 upstream callcheck { action: "gws_contacts.contact_groups.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent

Google Contacts at a glance

Sign-in: OAuth 2.0, authorization code with PKCE. You register your own OAuth app with Google Contacts, an admin signs in once, and you paste the app's client id and secret and the tokens from that sign-in; actionlake renews the access token from then on.
You provide: access_tokenrefresh_tokenclient_idclient_secret
Limits we pace to: 90 calls a minute, per connection
API covered: People API v1 (Discovery revision 20261020)people.googleapis.com
Built from: Google Contacts's documentation, read 23 October 2026people.googleapis.com developers.google.com
Service file: Version 1.0.0, signed (Ed25519)
Cached reads: 11 of 11 reads, for up to an hour; a write clears what it affects
Shared entities: 1, so ask can line Google Contacts up with your other systems
Data: Processed and stored in Sydney, Australia. No US region yet

Capabilities

What an AI agent can do in Google Contacts.

24 actions in 5 areas. Every one carries its effect, so a key can allow the reads and hold the rest.

11readlook, never change
9writecreate and update
4destructivewait for a confirmation

People
11
3 read · 5 write · 3 destructive
Create a contact · Get a person (contact, profile or people/me) · Update a contact · Search the signed-in user's contacts
Contact groups
7
3 read · 3 write · 1 destructive
List contact groups (labels) · Create a contact group (label) · Get a contact group · Rename a contact group
Other contacts
3
2 read · 1 write · 0 destructive
Copy an "Other contact" into My Contacts · List "Other contacts" (auto-saved interaction contacts) · Search "Other contacts"
Directory people
2
2 read · 0 write · 0 destructive
List people in the Workspace domain directory · Search the Workspace domain directory
Connections
1
1 read · 0 write · 0 destructive
List the signed-in user's contacts

Top actions

The Google Contacts API, shaped for agents.

The ids your agent types, what each does, and the one name it shares with other systems. 13 of Google Contacts's 13 action names are shared with at least one other connector, so an agent learns them once.

Action	What it does	Effect	Same name in
`gws_contacts.contact_groups.list`List contact groups (labels)	List all contact groups owned by the authenticated user.	read	`crm.contact_list.list`34 connectors
`gws_contacts.contact_groups.create`Create a contact group (label)	Create a new contact group owned by the authenticated user.	write	`crm.contact_list.create`29 connectors
`gws_contacts.connections.list`List the signed-in user's contacts	Provides a list of the authenticated user's contacts.	read	`crm.contact.list`177 connectors
`gws_contacts.people.create_contact`Create a contact	Create a new contact and return the person resource for that contact.	write	`crm.contact.create`161 connectors
`gws_contacts.directory_people.list`List people in the Workspace domain directory	Provides a list of domain profiles and domain contacts in the authenticated user's domain directory.	read	`identity.user.list`474 connectors
`gws_contacts.contact_groups.delete`Delete a contact group	Delete an existing contact group owned by the authenticated user by specifying a contact group resource name.	destructive	`crm.contact_list.delete`24 connectors
`gws_contacts.directory_people.search`Search the Workspace domain directory	Provides a list of domain profiles and domain contacts in the authenticated user's domain directory that match the search query.	read	`identity.user.search`40 connectors
`gws_contacts.people.batch_get`Get a person by resource name (batch endpoint)	Provides information about a list of specific people by specifying a list of requested resource names.	read	this connector
`gws_contacts.other_contacts.list`List "Other contacts" (auto-saved interaction contacts)	List all "Other contacts", that is contacts that are not in a contact group.	read	this connector
`gws_contacts.other_contacts.search`Search "Other contacts"	Provides a list of contacts in the authenticated user's other contacts that matches the search query.	read	this connector
`gws_contacts.people.batch_create_contacts`Create up to 200 contacts in one call	Create a batch of new contacts and return the PersonResponses for the newly Mutate requests for the same user should be sent sequentially to avoid increased…	write	this connector
`gws_contacts.contact_groups.modify_members`Add or remove contacts in a contact group	Modify the members of a contact group owned by the authenticated user.	write	this connector

Try it

Prompts to paste into Claude.

Each one names the Google Contacts actions it will call, so you know what it reads and what it changes before you send it.

Readread
List contact groups (labels) in Google Contacts and tell me what stands out.
callsgws_contacts.contact_groups.list
Writewrite
Create a contact group (label) in Google Contacts. Show me exactly what you will send before you save it.
callsgws_contacts.contact_groups.create

Governance for Google Contacts

Destructive actions wait for a yes.

4 Google Contacts actions are destructive. These are all of them:

Delete a contact groupgws_contacts.contact_groups.delete
Delete a contactgws_contacts.people.delete_contact
Delete a contact's photogws_contacts.people.delete_contact_photo
Delete up to 500 contacts in one callgws_contacts.people.batch_delete_contacts

A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.

dogws_contacts.contact_groups.deleteconfirm_policy: human

Delete a contact group?

intent: the user asked me to delete a contact group

run suspended · waiting for a named person · key gws-contacts-agent cannot confirm itself

In the console, or from an emailed signed link.

a key for this connector

account {  op: "keys.create", name: "gws-contacts-agent",  allowed_actions: ["gws_contacts.*"], cap_calls: 2000,  confirm_policy: "human_for_writes",  approval_rules: [    { match: "gws_contacts.contact_groups.delete", approver: "[email protected]" },    { match: "gws_contacts.people.delete_contact", approver: "[email protected]" },    { match: "gws_contacts.people.delete_contact_photo", approver: "[email protected]" }  ]}

Illustrative. Scoped to Google Contacts only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person.

Cost

What Google Contacts costs on actionlake.

Every Google Contacts action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call Google Contacts refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

1upstream call per actionall 24 Google Contacts actions
24actions pageeach page of a long list is one call
11reads can be cacheda cache hit costs nothing
100,000calls a month, freepaid plans from US$49 a month for 250,000

See pricing

Action index

Every Google Contacts action.

24 actions by area: the id your agent calls, what it does, and its effect.

People11

gws_contacts.people.batch_create_contactsCreate up to 200 contacts in one callwrite
gws_contacts.people.batch_delete_contactsDelete up to 500 contacts in one calldestructive
gws_contacts.people.batch_getGet a person by resource name (batch endpoint)read
gws_contacts.people.batch_update_contactsUpdate up to 200 contacts in one callwrite
gws_contacts.people.create_contactCreate a contactwrite
gws_contacts.people.delete_contactDelete a contactdestructive
gws_contacts.people.delete_contact_photoDelete a contact's photodestructive
gws_contacts.people.getGet a person (contact, profile or people/me)read
gws_contacts.people.search_contactsSearch the signed-in user's contactsread
gws_contacts.people.update_contactUpdate a contactwrite
gws_contacts.people.update_contact_photoSet a contact's photowrite

Contact groups7

gws_contacts.contact_groups.batch_getGet a contact group by resource name (batch endpoint)read
gws_contacts.contact_groups.createCreate a contact group (label)write
gws_contacts.contact_groups.deleteDelete a contact groupdestructive
gws_contacts.contact_groups.getGet a contact groupread
gws_contacts.contact_groups.listList contact groups (labels)read
gws_contacts.contact_groups.modify_membersAdd or remove contacts in a contact groupwrite
gws_contacts.contact_groups.updateRename a contact groupwrite

Other contacts3

gws_contacts.other_contacts.copy_to_my_contactsCopy an "Other contact" into My Contactswrite
gws_contacts.other_contacts.listList "Other contacts" (auto-saved interaction contacts)read
gws_contacts.other_contacts.searchSearch "Other contacts"read

Directory people2

gws_contacts.directory_people.listList people in the Workspace domain directoryread
gws_contacts.directory_people.searchSearch the Workspace domain directoryread

Connections1

gws_contacts.connections.listList the signed-in user's contactsread

Questions

The Google Contacts MCP server, answered.

Is there a Google Contacts MCP server for Claude?

Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 24 Google Contacts actions across people, contact groups, other contacts and directory people, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Google Contacts.

What do I need to connect Google Contacts?

Your own Google Contacts OAuth app, registered with Google Contacts (its client id and client secret), and the access and refresh tokens from one admin sign-in. actionlake has no Google Contacts app of its own, so this is not a one-step consent. actionlake renews the access token as it expires. The free call account { op: "connections.requirements", service: "gws_contacts" } lists exactly what to paste.

Can an AI agent delete or change things in Google Contacts?

Only if its key allows it, and only with an explicit confirmation. 4 Google Contacts actions are destructive, including delete a contact group, delete a contact and delete a contact's photo. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.

Will an AI agent use up my Google Contacts API limit?

actionlake paces every call to the limits in the Google Contacts service file: 90 calls a minute per connection. Repeated reads are answered from cache (11 Google Contacts actions can be), which never reaches Google Contacts.

What does a Google Contacts action cost?

One upstream call, the only unit actionlake bills. A list that pages bills one call per page (24 Google Contacts actions page). Cache hits, searches, dry runs and calls Google Contacts refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

Which Google Contacts API does it cover?

The People API v1 (Discovery revision 20261020) at people.googleapis.com. It is built from Google Contacts's documentation as read on 23 October 2026. 24 actions in 5 areas, each one in the signed service file (version 1.0.0).

Does actionlake keep my Google Contacts data, and where?

actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to an hour, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Google Contacts credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.

Which AI clients can use it?

Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.

Give your agent Google Contacts today.

Connect Google Contacts free See pricing

Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.

Google Contacts MCP server for AI agents.

Connect Google Contacts in three steps.

Add actionlake to Claude.

Connect Google Contacts.

Make the first call. Check before a write.

What an AI agent can do in Google Contacts.

People

Contact groups

Other contacts

Directory people

Connections