Google Contacts Connector for AI agents.
9 live capabilities
Manage your entire address book and CRM data through conversational commands.
Waiting for input…
Why people use Google Contacts
Google Contacts for Faster CRM and Lead Management
This Connector ends the cycle. Your AI agent becomes the interface for your directory. You tell the agent to find the lead, and it pulls the info. You tell it to update the phone number, and it does it. You stay in your flow.
What Vinkius changes
You get a conversational interface for your entire Google Contacts directory.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
Lead Management
An SDR finds a lead's email using search_contacts and then asks the agent to create a new group for them to track the funnel.
- Real-world use case 02
Data Cleanup
An assistant asks the agent to find all contacts with 'Test' in the name and then uses delete_contact to remove them.
- Real-world use case 03
Quick Reference
A developer asks for a client's phone number and gets it via get_contact without ever leaving their code editor.
Complete set · 9capabilities
The complete Google Contacts capability set.
These are the exact actions your AI can choose when you ask it to work with Google Contacts.
01—03
3 capabilities in this set.
Part of 9 available through Google Contacts.
- 01 Capability
Create contact group
Create a new label or group to organize your connections. This helps you categorize your network for better sorting.
- 02 Capability
Get contact
Retrieve the full profile of a specific connection. This is useful for getting all details for a single person.
- 03 Capability
List contact groups
See every group and label currently in your directory. This gives you an overview of your organization structure.
04—06
3 capabilities in this set.
Part of 9 available through Google Contacts.
- 04 Capability
List contacts
Get a list of all the connections in your account. Use this to see your entire network at a glance.
- 05 Capability
Search contacts
Find specific people using a name, email, or other query. This is the fastest way to locate a specific person.
- 06 Capability
Create contact
Add a new person to your directory with their primary details. Use this to save new leads or connections instantly.
07—09
3 capabilities in this set.
Part of 9 available through Google Contacts.
- 07 Capability
Delete contact
Remove an old or incorrect contact from your list. This keeps your directory clean and accurate.
- 08 Capability
Get contact group
Fetch the specific details of a single contact group. Use this to see who belongs to a certain category.
- 09 Capability
Update contact
Modify an existing contact's information using a provided etag. Use this to keep your contact data current.
Set up in minutes
One URL. Then ask Google Contacts to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Google Contacts from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_gV7uG1cqnAAo5NFgiMaqZw9EWavgoPjExQU9paKG/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Google Contacts, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Google Contacts for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_gV7uG1cqnAAo5NFgiMaqZw9EWavgoPjExQU9paKG/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Google Contacts URL.
- Step 03
Save and start
Save the connection and enable Google Contacts in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"google-contacts": {
"url": "https://edge.vinkius.com/vk_preview_gV7uG1cqnAAo5NFgiMaqZw9EWavgoPjExQU9paKG/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Google Contacts
Open Agent mode in chat and ask: "Using Google Contacts, help me...". 9 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"google-contacts": {
"url": "https://edge.vinkius.com/vk_preview_gV7uG1cqnAAo5NFgiMaqZw9EWavgoPjExQU9paKG/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Google Contacts
Ask Copilot: "Using Google Contacts, help me...". 9 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"google-contacts": {
"url": "https://edge.vinkius.com/vk_preview_gV7uG1cqnAAo5NFgiMaqZw9EWavgoPjExQU9paKG/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Google Contacts
Open Cascade and ask: "Using Google Contacts, help me...". 9 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"google-contacts": {
"url": "https://edge.vinkius.com/vk_preview_gV7uG1cqnAAo5NFgiMaqZw9EWavgoPjExQU9paKG/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Google Contacts
Ask Cline: "Using Google Contacts, help me...". 9 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add google-contacts --transport http "https://edge.vinkius.com/vk_preview_gV7uG1cqnAAo5NFgiMaqZw9EWavgoPjExQU9paKG/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Google Contacts
Ask Claude: "Using Google Contacts, show me...". 9 tools are ready
Where the request belongs
Work Google Contacts can move forward.
This is for people who live in their contacts, like sales reps juggling hundreds of leads, executive assistants managing complex networks, and developers who need quick info without leaving their code.
Sales Development Representative (SDR)
Pulls prospect details and updates contact cards during live calls without switching tabs.
Executive Assistant
Organizes large networks into specific groups and keeps the directory clean and structured.
Software Developer
Fetches contact data directly in the IDE to avoid context switching during development.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsZoho CRM Contacts
Search, create, and manage contacts, leads, and accounts. with lead conversion and related records in Zoho CRM.
folk
Manage relationships across sales, recruiting, and partnerships with a lightweight CRM that syncs contacts from everywhere.
Nylas
Equip your AI agent to manage emails, calendars, and contacts across all providers (Gmail, Outlook) through a single unified interaction.
Sansan
Digitize and manage business cards via AI. browse contacts, verify details, and explore your company's network effortlessly.
Aventri
Manage events, contacts, and speakers via Aventri. list events, search contacts, and clone event modules directly from your AI agent.
Capsule CRM
Manage contacts, sales opportunities, and projects via Capsule CRM. search parties, track pipelines, and manage tasks directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep Google Contacts connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Google Contacts.
The practical details behind the request, access and result.
Can the Google Contacts MCP help me manage my CRM?
Yes, it works as a direct bridge to your Google Contacts, allowing your agent to find, create, and update lead information just like a CRM.
Will this Connector delete my actual Google Contacts?
It can only delete a contact if you specifically ask your agent to do so using the delete capability. It won't happen automatically.
Can I use Google Contacts MCP to search for people by their email?
Yes, you can ask your agent to find anyone in your directory using their email address or any other identifying info.
How does the Google Contacts MCP handle contact groups?
It can list all your current groups and even create new ones, making it easy to keep your network organized by category.
Is my Google Workspace data safe with this Connector?
The connection is handled through a secure authentication flow, ensuring your agent only accesses the data you permit.
Can I update a contact's phone number using the Google Contacts MCP?
Yes, your agent can modify existing contact details like phone numbers or emails whenever you provide the new information.
Which exact service and endpoints does this utilize?
This integration leverages the highly structured Google People API. It strictly filters and returns core metadata (emails, names, numbers) avoiding unnecessary heavy payloads.
Can it automatically assign new prospects into specific mailing groups?
Certainly. The create_contact capability allows passing a specific Group Identifier (which you can discover using list_contact_groups). The user will instantly appear in the matching mailing segment.
What happens if I try to list a corporate directory with thousands of interconnected contacts?
The integration is protected by aggressive egress control pagination features out-of-the-box. Your AI agent handles paginated loops automatically and queries intelligent searches to restrict context overhead limits naturally.
Is it possible to manage shared domain profiles or only my personal Gmail connections?
Assuming you are logged in using a Google Workspace suite, the authorization supports cross-referencing domain contacts. Personal Gmail queries apply strict visibility bounding towards individual connections only.
One connection away
Give your agent a direct line to Google Contacts.
Connect Google Contacts once. Keep it beside 6,100+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available