Google Contacts Integration

The Google Contacts integration provides access to list, search, create, update, and delete Google Contacts via the People API through the Integrate MCP server.

Installation

The Google Contacts integration is included with the SDK:

import { googleContactsIntegration } from "integrate-sdk/server";

Setup

1. Create a Google Contacts OAuth App

1. Go to Google Cloud Console
2. Create a new OAuth application
3. Configure your redirect URI
4. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the Google Contacts integration to your server configuration. The integration automatically reads GOOGLE_CONTACTS_CLIENT_ID and GOOGLE_CONTACTS_CLIENT_SECRET from your environment variables:

import { createMCPServer, googleContactsIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    googleContactsIntegration({
    }),
  ],
});

You can override the environment variables by passing explicit values:

googleContactsIntegration({
  clientId: process.env.CUSTOM_GOOGLE_CONTACTS_ID,
  clientSecret: process.env.CUSTOM_GOOGLE_CONTACTS_SECRET,
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";

await client.authorize("google_contacts");
const result = await client.google_contacts.batchGetContacts({});

console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, googleContactsIntegration } from "integrate-sdk";

const customClient = createMCPClient({
  integrations: [googleContactsIntegration()],
});

Configuration Options

Tools

google_contacts_batch_get_contacts

Contacts batch get contacts

google_contacts_copy_other_contact

Contacts copy other contact

google_contacts_create_contact

Contacts create contact

google_contacts_delete_contact

Contacts delete contact

google_contacts_get_person

Contacts get person

google_contacts_get_self

Contacts get self

google_contacts_list_connections

Contacts list connections

google_contacts_list_other_contacts

Contacts list other contacts

google_contacts_search_contacts

Contacts search contacts

google_contacts_update_contact

Contacts update contact

Notes

• Category: Communication
• Authentication mode: OAuth