# Google Contacts MCP for AI Agents AI Agent Connect > Google Contacts MCP lets your AI agent read, search, and update your Google Contacts directory directly. You can manage your entire network of connections without leaving your chat or IDE. It handles everything from finding a specific phone number to creating new groups and updating contact details on the fly. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_gV7uG1cqnAAo5NFgiMaqZw9EWavgoPjExQU9paKG/ai-agent-connect - **Tags:** contact-management, address-book, directory-sync, crm-integration, data-organization ## Description This Connector connects your Google Contacts directory to your AI agent so you can manage your entire address book through a simple conversation. Instead of hunting through tabs and menus, you can just tell your agent to find a phone number, update an email, or create a new group. It turns your static directory into a live, searchable database that stays in sync with your workspace. You can pull prospect details for a sales call or organize your network into project-specific labels without ever leaving your chat window. It's a way to stop the constant tab-switching and keep your data where you're actually working. You'll find it makes keeping your network organized a lot less of a chore. This is one of the many ways Vinkius helps you bridge the gap between your favorite tools and your daily tasks. ## Tools ### create_contact_group Create a new label or group to organize your connections. This helps you categorize your network for better sorting. ### get_contact Retrieve the full profile of a specific connection. This is useful for getting all details for a single person. ### list_contact_groups See every group and label currently in your directory. This gives you an overview of your organization structure. ### list_contacts Get a list of all the connections in your account. Use this to see your entire network at a glance. ### search_contacts Find specific people using a name, email, or other query. This is the fastest way to locate a specific person. ### create_contact Add a new person to your directory with their primary details. Use this to save new leads or connections instantly. ### delete_contact Remove an old or incorrect contact from your list. This keeps your directory clean and accurate. ### get_contact_group Fetch the specific details of a single contact group. Use this to see who belongs to a certain category. ### update_contact Modify an existing contact's information using a provided etag. Use this to keep your contact data current. ## Prompt Examples **Prompt:** ``` Find the phone number for Sarah Jenkins in my contacts. ``` **Response:** ``` I've searched your directory. I found Sarah Jenkins. Her primary mobile number is **+1 (555) 987-6543**. Would you like me to send her a message or pull more details? ``` **Prompt:** ``` Create a new contact for a lead named Mike Ross with the email m.ross@example.com. ``` **Response:** ``` Done. I've added **Mike Ross** to your Google Contacts. His primary email is set as `m.ross@example.com`. I've also flagged him as a new lead. ``` **Prompt:** ``` Show me all my contact groups so I can see how I've organized my network. ``` **Response:** ``` I've pulled your current groups. Here is how your directory is organized: * **Lead Funnel 2024** (42 contacts) * **Tech Advisors** (12 contacts) * **Starred Favorites** (5 contacts) Would you like to see the members of a specific group? ``` ## Capabilities ### Search for specific people Find anyone in your directory by name, email, or other identifiers. ### Create new contact profiles Add new people to your directory with full details in one go. ### Update existing contact info Modify phone numbers, emails, or other details for your current connections. ### List all contact groups See every label and group currently in your directory. ### Delete old records Remove outdated or incorrect contacts from your address book. ### Get full contact details Retrieve the complete profile for any specific connection. ## Use Cases ### 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. ### Data Cleanup An assistant asks the agent to find all contacts with 'Test' in the name and then uses delete_contact to remove them. ### Quick Reference A developer asks for a client's phone number and gets it via get_contact without ever leaving their code editor. ### Network Organization A user asks the agent to find all 'Tech Advisors' and list their details to prepare for a meeting. ## Benefits - Stop switching tabs to find phone numbers by using search_contacts directly in your chat. - Keep your CRM clean by having your agent use delete_contact to remove outdated leads. - Organize your network faster by creating custom labels with create_contact_group. - Update prospect details on the fly with update_contact during active conversations. - Get a bird's-eye view of your network by using list_contacts to see everyone you know. - Reduce data entry time by letting your agent use create_contact to save new leads instantly. ## How It Works The bottom line is you get a conversational interface for your entire Google Contacts directory. 1. Subscribe to the Google Contacts MCP on Vinkius. 2. Connect your Google Workspace account through the secure authentication flow. 3. Start asking your AI client to find, create, or organize contacts in your directory. ## Frequently Asked Questions **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 tool. 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` 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.