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

export interface GoogleContactsIntegrationConfig {
  /** Google OAuth client ID (defaults to GOOGLE_CONTACTS_CLIENT_ID env var) */
  clientId?: string;

Tools

google_contacts_batch_get_contacts

Contacts batch get contacts

export type GoogleContactsBatchGetContactsParams = Record<string, unknown>;

google_contacts_copy_other_contact

Contacts copy other contact

export type GoogleContactsCopyOtherContactParams = Record<string, unknown>;

google_contacts_create_contact

Contacts create contact

export type GoogleContactsCreateContactParams = Record<string, unknown>;

google_contacts_delete_contact

Contacts delete contact

export type GoogleContactsDeleteContactParams = Record<string, unknown>;

google_contacts_get_person

Contacts get person

export type GoogleContactsGetPersonParams = Record<string, unknown>;

google_contacts_get_self

Contacts get self

export type GoogleContactsGetSelfParams = Record<string, unknown>;

google_contacts_list_connections

Contacts list connections

export type GoogleContactsListConnectionsParams = Record<string, unknown>;

google_contacts_list_other_contacts

Contacts list other contacts

export type GoogleContactsListOtherContactsParams = Record<string, unknown>;

google_contacts_search_contacts

Contacts search contacts

export type GoogleContactsSearchContactsParams = Record<string, unknown>;

google_contacts_update_contact

Contacts update contact

export type GoogleContactsUpdateContactParams = Record<string, unknown>;

Notes

• Category: Communication
• Authentication mode: OAuth