# Google Contacts MCP > Google Contacts MCP connects your entire Google address book directly to any AI agent. You can manage contacts—creating new entries, looking up details, updating records, or grouping people by label—all through natural conversation. It gives your agent complete control over who you know and how your connections are organized. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** contact-management, address-book, directory-sync, crm-integration, data-organization ## Description Connect this MCP to your preferred AI client and take full command of your Google Contacts directory. You no longer have to open separate web tabs just to find a phone number or update someone’s title. Instead, you talk to your agent, and it handles the data retrieval for you. Your agent can look up specific connections by name or email. It'll pull detailed profiles instantly, allowing you to get the latest work numbers or personal emails without clicking through menus. Need to organize people? You can list all existing contact groups and build new ones based on shared labels—all in a single chat session. If you’re working with client data, this MCP lets your agent search across your entire address book using just a few keywords. If a profile needs updating, it handles that too. Because Vinkius hosts all the connections here, you get one reliable place to manage these core business relationships from any AI-compatible platform. ## Tools ### create_contact_group Creates a new organizational group (label) within your contacts. ### create_contact Adds an entirely new individual to your contact list. ### delete_contact Permanently removes a specified contact record from the directory. ### get_contact_group Retrieves details for an existing, specific contact group. ### get_contact Fetches all detailed information for one particular contact. ### list_contact_groups Shows a list of every existing labeled group you've created or inherited. ### list_contacts Retrieves a simple list of all contacts in your address book. ### search_contacts Searches the entire contact database using general keywords or criteria. ### update_contact Modifies information on an existing contact record, requiring a unique identifier for accuracy. ## Prompt Examples **Prompt:** ``` Search my contacts for John Doe and give me his phone number. ``` **Response:** ``` Scanning directory... I reached John Doe. His primary mobile number is registered as +1 (555) 123-4567 and his core email is john.doe@example.com. ``` **Prompt:** ``` Create a new contact named Alice Smith with email alice@example.com ``` **Response:** ``` Successfully issued creation. The identity 'Alice Smith' has been persisted correctly with ID 'people/c230919321', keeping 'alice@example.com' as her primary routing channel. ``` **Prompt:** ``` List all organizational contact groups available. ``` **Response:** ``` I've fetched the segments. Found 3 notable groupings mapping connections: 'Starred in Android' (32 users), 'Lead Funnel 2024' (81 prospects), and 'Tech Advisors' (5 users). Would you like to check the Advisors list? ``` ## Capabilities ### Find and look up contact details Retrieve complete profiles for specific individuals using their name or email address. ### Create new connections Build entirely new contact records and add them to your main directory. ### Update existing contacts Modify details on a known contact, like changing an email address or job title. ### Manage organizational groups List all your current labeled groupings and create new ones to sort specific connections. ### Search the entire directory Run complex lookups across your full contact list using a query string. ## Use Cases ### A sales rep needs immediate prospect info. The SDR is on a call and realizes they don't have the latest phone number. Instead of promising to check later, they ask their agent: 'What's John Doe’s mobile number?' The agent uses 'get_contact' and instantly replies with the accurate details, keeping the sales momentum going. ### An EA needs to organize a meeting group. The executive needs to pull together everyone related to the Q3 marketing launch. They ask their agent to 'List all contacts labeled Marketing Leads.' The agent uses 'list_contact_groups' and pulls up exactly the 40 people needed, saving minutes of manual filtering. ### A developer needs clean data for a script. The dev is writing a small internal tool that requires validated contact names. They ask their agent to 'Search contacts by company: Acme Corp.' The agent uses 'search_contacts' and outputs a clean, structured list ready to be dropped into code. ### A user needs to correct old data. The user remembers that Jane Smith moved last month. They ask their agent: 'Update Jane Smith’s address.' The agent uses the necessary tools, updating her record accurately without requiring the user to find the specific API endpoint. ## Benefits - You get instant details. Instead of clicking through Google's site to find a phone number, you just ask your agent for it and get the full profile in seconds. - Organization is simple. Need to segment leads? Use tools like 'list_contact_groups' and 'create_contact_group' to build tailored lists instantly, keeping everyone sorted by label. - Updating records takes zero steps. If a contact changes jobs or gets a new number, use the 'update_contact' tool through your agent instead of manually logging into multiple systems. - New contacts are fast. Use 'create_contact' to quickly add someone you just met, capturing their details without opening an email draft or external form. - Deep search capability means nothing falls through the cracks. You can use 'search_contacts' to pull up specific records across your entire book using a natural query. ## How It Works The bottom line is you talk to your AI client, not Google's website. 1. Subscribe to this MCP and authenticate it securely with your Google Workspace account. 2. Your AI client establishes the connection, giving your agent read/write access to your contact directory. 3. You ask your agent a question in plain language (e.g., 'Find all tech advisors'). The agent executes the necessary tool calls and replies with the structured data. ## Frequently Asked Questions **How do I use Google Contacts MCP to find a person's number?** You simply ask your agent to search for the person by name or email. The agent uses 'get_contact' and returns the full profile, including their primary mobile number. **Can I use Google Contacts MCP to create a new group?** Yes, you can run the 'create_contact_group' tool through your agent. This allows you to build labeled segments for your connections right from your chat interface. **What if I need to update an existing contact? Do I need special info?** Yes, when updating a record using 'update_contact', the agent needs specific identifiers (like an etag) to ensure it’s modifying the correct person's data. **Is Google Contacts MCP only for US contacts?** No. It connects directly to your entire Google Workspace directory, meaning it handles all international connections and labels you manage within that account. **How many tools are available in the Google Contacts MCP?** This MCP provides nine specific tools covering everything from listing groups using 'list_contact_groups' to deleting records with 'delete_contact'.