Google Contacts MCP. Find, update, and organize your entire address book.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Google Contacts lets your AI client manage your entire address book. Use this server to list, search, create, update, and delete individual contacts or organizational groups directly from your conversation window.
You don't have to open Google Contacts; you just ask your agent for the data.
What your AI agents can do
Create contact
Adds a new person record (connection) to your address book.
Create contact group
Establishes and saves a new organizational group label.
Delete contact
Removes an existing contact from your directory permanently.
Run targeted searches against your entire address book using a query string.
Fetch the complete profile and details for one specific contact record.
Add a brand-new connection to your address book.
Change data (like phone numbers or emails) on an existing contact profile using its unique etag.
List all the organizational groups you belong to, and check details for specific group structures.
Permanently remove a contact from your directory.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Google Contacts MCP Server: 9 Tools for Contact Management
Use these tools to manage every aspect of your address book—from searching specific connections to building complex contact groups.
019d75a8create contact
Adds a new person record (connection) to your address book.
019d75a8create contact group
Establishes and saves a new organizational group label.
019d75a8delete contact
Removes an existing contact from your directory permanently.
019d75a8get contact
Retrieves the full profile details for a single, specific person by their ID.
019d75a8get contact group
Gets all members and details associated with one specified contact group.
019d75a8list contact groups
Lists every organizational label or grouping you have set up in your contacts.
019d75a8list contacts
Retrieves a list of all the connections currently in your address book.
019d75a8search contacts
Runs a general search across your contacts using keywords or partial data strings.
019d75a8update contact
Modifies the details of an existing contact, requiring an etag for safety.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Google Contacts, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Listen up. This isn't just another contact list; it’s your entire address book, connected directly to your chat window. You don't gotta jump into Google Contacts or anything—you just tell your agent what you need and get the data right here.
Managing Your Connections
Need to find someone? Run a search across every single connection in your directory using search_contacts; it takes a query string and spits out results. If you know exactly who you're talking to, you can fetch their full profile details by ID with get_contact. You wanna see everything associated with that specific person—their work history, phone numbers, the whole nine yards? That’s what get_contact gives ya.
Changing Records and Adding People
Want to fix someone's number or update their job title? Use update_contact. Just remember: it requires an etag—that unique safety token you get from a prior get_contact call—so you don’t accidentally overwrite good data. If the info is missing, no sweat; you can add a brand-new connection using create_contact. That's how you build out your list.
Handling Groups and Labels
Your contacts aren't just random names; they're organized. To see every label or grouping you've set up, run list_contact_groups. If you want to check the full membership roster for one specific group, use get_contact_group, which pulls all members and details from that selected structure. You can also get a general overview of every single organizational label in your contacts with list_contact_groups.
Clearing Out Junk
Got dead leads or old numbers you gotta ditch? You use delete_contact. This tool permanently removes an existing contact from your directory—it’s final, so be sure you're ready to go.
What It Means For Your Workflow
Basically, this server lets your agent treat your contacts like a dynamic database. You can list every connection using list_contacts for a full dump of everything in the book. If you gotta build out structure, you use create_contact_group to establish and save that new organizational label. This system gives you total control: search names with search_contacts, get profiles with get_contact, modify info with update_contact, drop people with delete_contact, and keep your groups tight by listing and checking them with dedicated group tools.
You don't gotta open anything else; just ask your agent.
How Google Contacts MCP Works
- 1 First, subscribe to the Google Contacts server and securely authenticate it with your Google Workspace account.
- 2 Next, prompt your agent for an action—like 'Get John Doe's number.' The agent calls the appropriate tool (e.g.,
get_contact). - 3 Finally, the server executes the operation against your directory and returns clean data to your client, allowing you to act on it immediately.
The bottom line is: Your AI client talks to Google Contacts directly, keeping all your address book actions inside the chat window.
Who Is Google Contacts MCP For?
This is for anyone who gets annoyed by having to switch between their CRM/Google and their communication tool. It's for sales reps who need fast prospect data, EAs juggling hundreds of connections, or developers who want contact info right in the IDE without clicking through menus.
Needs to instantly pull up a prospect's last known phone number and email address while talking to them on a call, then update that info with update_contact.
Has to build ad-hoc groups of contacts—like 'All Tech Leads in Chicago'—by calling list_contact_groups and filtering results for meetings.
Requires a precise contact email or ID for testing scripts. They use get_contact to pull specific data into their code environment without opening an external window.
What Changes When You Connect
- Stop opening tabs. You can find contact details for a prospect or coworker instantly by having your agent call
search_contactsdirectly from the chat window. - Never lose track of network segments again. Use
list_contact_groupsto see all organizational labels, then useget_contact_groupto check who's in 'Marketing Leads'.
Real-World Use Cases
Onboarding a New Client
You need to add five new contacts and assign them to the 'Project Phoenix' group. Instead of manually creating records, you ask your agent: 'Create these five contacts and put them in Project Phoenix.' The agent runs create_contact multiple times and then uses create_contact_group.
Updating Sales Data
You talk to a prospect, and their email changes. You don't want to manually update the record. You tell your agent: 'Update Jane Doe's primary email.' The agent uses get_contact (to get the etag) then calls update_contact, ensuring the change sticks.
Audit Cleanup
Your manager asks you to clean up old, inactive contacts. You tell your agent: 'List all connections that haven't been touched in six months.' The agent runs list_contacts and helps you identify which ones need deleting using delete_contact.
Quick Reference Check
You remember a name, but not the email. You ask: 'What's Sarah Chen's mobile number?' The agent runs search_contacts, pulls up her profile, and reads out the specific phone number you need.
The Tradeoffs
Assuming one tool does everything
Asking your agent, 'Give me all contacts from my company.' This is too vague; the system doesn't know if you mean a group, a search query, or an entire list.
→
Be specific. First, use list_contact_groups to see available groups. Then, ask your agent to 'List members of [Group Name]' using get_contact_group.
Overwriting data by forgetting the etag
Attempting to update a contact without first calling get_contact, which results in an API error and no change.
→
Always remember: To use update_contact, you must first call get_contact to retrieve the unique etag. It's required for data integrity.
When It Fits, When It Doesn't
Use this server if your workflow requires constant, conversational access to address book details—if finding or changing a contact is part of a conversation (e.g., 'Send X an email and update their status'). Don't use it if you just need general data visualization or reporting across multiple sources; for that, look at a dedicated CRM integration tool. If your only task is to read static documents containing names, use basic text extraction instead. But if you need to act on the contact data (create, update, delete), this set of tools covers it.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Google Contacts. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 9 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Juggling contacts across chat apps and spreadsheets sucks.
Today, finding a single person's phone number means switching from your chat client to Google Contacts. You search by name, click into the profile, find the email, copy it, then paste it into a message or spreadsheet. It’s four different windows and three chances for copy-paste failure.
With this MCP server, you just ask your agent: 'What's John Doe's phone number?' The agent runs `search_contacts`, pulls the data instantly, and gives you the number back in the chat window. That's it.
Google Contacts MCP Server: Manage contacts with a single prompt.
Manual tasks like building new groups or updating fields used to be multi-step processes. You had to manually list the group, then find members, and then edit each person's card individually.
Now, you simply tell your agent: 'Create a group for all leads from Q3.' The server handles listing, filtering, and creating the label—all with one prompt.
Common Questions About Google Contacts MCP
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 tool 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.
When using the `update_contact` tool, how does it handle version conflicts or concurrency issues? +
The server requires an E-tag to prevent lost updates. You must first call get_contact to retrieve the current contact's unique E-tag; this token is mandatory when executing the update_contact function.
If I run `create_contact` and provide invalid data, such as a malformed email address or missing required fields, what happens? +
The API validates inputs against Google's standards. Instead of failing silently, it returns specific error codes detailing exactly which field failed validation and why the creation attempt was rejected.
How is my data access scope limited when calling `list_contacts` to ensure I only see contacts relevant to me? +
The server strictly adheres to your authenticated Google Workspace permissions. It will never expose directories or connections outside of the user account that established the secure connection.
Does the `get_contact` tool return basic details only, or does it pull comprehensive information about a contact? +
It pulls the full profile record. The output includes primary mobile numbers, secondary phone lines, email addresses, physical locations, and all associated group memberships.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
BigCommerce
Manage your online store with product catalogs, order fulfillment, and customer data for high-volume e-commerce operations.
Amazon Marketing Cloud
Advanced advertising analytics — execute SQL queries and monitor workflows via AI.
Temu Seller Hub
Automate cross-border e-commerce ops via Temu — manage orders, track fulfillment, sync inventory, and process returns natively from any AI agent.
You might also like
Aliyun VOD / 阿里云视频点播
Alibaba Cloud's professional video pipeline — manage media, retrieve play URLs, and audit transcode templates via AI.
REST Countries Alternative
Access comprehensive global data including country names, capitals, currencies, and languages via the REST Countries API.
STF Dados Abertos
Access open data from the Brazilian Supreme Federal Court (STF) — explore datasets, resources, and institutional organizations via AI.