# Google Contacts

> Connect Google Contacts so your AI can look up anyone you know, including people you've emailed: names, emails, phone numbers and companies.

Connect Google Contacts so your AI can find people's email addresses, phone numbers and companies. It searches your saved contacts and your "other contacts": people you've emailed, which Google saves for you automatically.

## What your AI can do

Contacts are read-only: your AI can look people up, but never adds, changes or deletes contacts.

- **Search contacts** (`contacts_search`): finds people by name, email, phone number or company, in your saved contacts and other contacts. Up to 60 results.
- **List contacts** (`contacts_list`): your saved contacts, most recently changed first, page by page (up to 1,000 at a time).
- **Get a contact** (`contacts_get`): everything saved for one person: emails, phones, organisation, addresses, notes, birthday and links.

Try asking:

- "What's the phone number for Priya Shah at Northwind?"
- "Who do I know at Acme, and when did I add them?"
- "Find everyone in my contacts at a .gov.uk address."
- "Find my accountant's email and draft them a note about this year's receipts." (with an email account in the same MCP server)

## What you need

- A Google account (personal or Google Workspace).

## Connect Google Contacts

You sign in on Google's own page; Plugsight never sees your password.

1. In [app.plugsight.app](https://app.plugsight.app), go to **Connections** and click **Add connection**.
2. Click **Contacts**, then the **Google Contacts** tile. The **Connect Google Contacts** page shows what Google will ask.
3. Click **Continue to Google**.
4. **Choose your Google account.**
5. If Google says **Google hasn't verified this app**, click **Advanced**, then **Go to Plugsight (unsafe)**. Google shows this while it reviews new apps; it doesn't mean anything is wrong.
6. **Tick the permission boxes.** Google asks *"See and download your contacts"*, which is required, and *"See and download contact info automatically saved in your 'Other contacts'"*, which is optional. Tick both so your AI can also find people you've emailed but never saved.
7. You're back in Plugsight, with a message saying how many contacts it found, such as `Connected you@gmail.com: 1,240 contacts.`

> [!NOTE]
> If you leave "Other contacts" unticked, the connection still works, but searches cover only your saved contacts. To add it later, connect Google Contacts again and tick it.

## What it can and can't change

Nothing. On **Connections**, the connection shows **Read-only** with no switch.

## Troubleshooting

### Google Contacts access wasn't granted. Tick the permission and try again.

**What it means:** the box *"See and download your contacts"* was left unticked on Google's screen.

**How to fix it:** click the tile again, and tick that box. Tick "Other contacts" too, if you want your AI to find people you've emailed.

### Google returned no refresh token. Remove the app's access in your Google account and try again.

**What it means:** Google didn't give Plugsight lasting access, so the connection couldn't be saved.

**How to fix it:** remove Plugsight's access in your Google account, then connect again.

### You didn't allow access in Google. Click Connect again and allow it, ticking every permission box.

**What it means:** access wasn't allowed on Google's screen.

**How to fix it:** click the tile again and allow access.

### This MCP has 2 contacts connections; pass account (one of: …).

**What it means:** the MCP server has more than one contacts connection, and your AI didn't say which to use.

**How to fix it:** name it in your request, for example "in my Google contacts".

## Related articles

- [Outlook Contacts](https://docs.plugsight.app/connectors/outlook-contacts.md)
- [iCloud Contacts](https://docs.plugsight.app/connectors/icloud-contacts.md)
- [Google Calendar](https://docs.plugsight.app/connectors/google-calendar.md)
- [Gmail](https://docs.plugsight.app/connectors/gmail.md)
- [Contacts tools](https://docs.plugsight.app/developers/contacts-tools.md)
- [Look up a contact's details](https://docs.plugsight.app/recipes/look-up-a-contact.md)

---

Web version: https://docs.plugsight.app/connectors/google-contacts
