update_contact_group

Modify the name and custom data of an existing contact group in Google Contacts. Use this tool to rename groups or update associated metadata for better organization.

Instructions

Update a contact group's name and custom data.

    Args:
        resource_name: Contact group resource name (e.g., "contactGroups/12345")
        name: New name for the contact group
        client_data: Optional updated custom data as list of key-value pairs

Input Schema

TableJSON Schema

Name	Required	Description	Default
`resource_name`	Yes
`name`	Yes
`client_data`	No

Implementation Reference

src/tools.py:476-496 (handler)

MCP tool handler: async function decorated with @mcp.tool() that initializes the service, calls service.update_contact_group, formats the result, and handles errors.

@mcp.tool()
async def update_contact_group(
    resource_name: str, name: str, client_data: List[Dict[str, str]] = None
) -> str:
    """Update a contact group's name and custom data.

    Args:
        resource_name: Contact group resource name (e.g., "contactGroups/12345")
        name: New name for the contact group
        client_data: Optional updated custom data as list of key-value pairs
    """
    service = init_service()
    if not service:
        return "Error: Google Contacts service is not available. Please check your credentials."

    try:
        group = service.update_contact_group(resource_name, name, client_data)
        return f"Contact group updated successfully!\n\n{format_contact_group(group)}"
    except Exception as e:
        return f"Error: Failed to update contact group - {str(e)}"

src/google_contacts_service.py:1159-1199 (helper)

Service helper method in GoogleContactsService that performs the Google People API call to update the contact group, handling ETag for concurrency and formatting the response.

def update_contact_group(
    self, resource_name: str, name: str, client_data: Optional[List[Dict[str, str]]] = None
) -> Dict[str, Any]:
    """Update a contact group's name and client data.

    Args:
        resource_name: Contact group resource name
        name: New name for the contact group
        client_data: Optional updated client data

    Returns:
        Updated contact group dictionary
    """
    try:
        # Get current group for etag
        current_group = self.service.contactGroups().get(resourceName=resource_name).execute()

        contact_group_body = {
            "contactGroup": {
                "resourceName": resource_name,
                "etag": current_group.get("etag"),
                "name": name,
            },
            "updateGroupFields": "name",
        }

        if client_data:
            contact_group_body["contactGroup"]["clientData"] = client_data
            contact_group_body["updateGroupFields"] = "name,clientData"

        response = (
            self.service.contactGroups()
            .update(contactGroup_resourceName=resource_name, body=contact_group_body)
            .execute()
        )

        return self._format_contact_group(response)

    except HttpError as error:
        raise GoogleContactsError(f"Error updating contact group: {error}")

src/main.py:71-74 (registration)
Registration point where the MCP server is created and register_tools(mcp) is called, which in turn calls register_contact_group_tools(mcp) to define/register the update_contact_group tool via decorator.
```
mcp = FastMCP("google-contacts")

# Register all tools
register_tools(mcp)
```

MCP Google Contacts Server