add_contacts_to_group

Assign labels to Google Contacts by adding them to contact groups for better organization and management.

Instructions

Add contacts to a contact group (assign a label to contacts).

    Args:
        group_resource_name: Contact group resource name (e.g., "contactGroups/12345")
        contact_resource_names: List of contact resource names to add (e.g., ["people/12345", "people/67890"])

Input Schema

TableJSON Schema

Name	Required	Description	Default
`group_resource_name`	Yes
`contact_resource_names`	Yes

Implementation Reference

src/tools.py:517-536 (handler)

MCP tool handler function for 'add_contacts_to_group'. Decorated with @mcp.tool() for registration. Initializes service and calls the underlying service method to perform the operation.

@mcp.tool()
async def add_contacts_to_group(
    group_resource_name: str, contact_resource_names: List[str]
) -> str:
    """Add contacts to a contact group (assign a label to contacts).

    Args:
        group_resource_name: Contact group resource name (e.g., "contactGroups/12345")
        contact_resource_names: List of contact resource names to add (e.g., ["people/12345", "people/67890"])
    """
    service = init_service()
    if not service:
        return "Error: Google Contacts service is not available. Please check your credentials."

    try:
        result = service.add_contacts_to_group(group_resource_name, contact_resource_names)
        return format_group_membership_result(result, "add")
    except Exception as e:
        return f"Error: Failed to add contacts to group - {str(e)}"

src/google_contacts_service.py:1216-1247 (helper)

Core service implementation that interacts with Google Contacts API to add contacts to a group using the contactGroups.members.modify endpoint.

def add_contacts_to_group(
    self, group_resource_name: str, contact_resource_names: List[str]
) -> Dict[str, Any]:
    """Add contacts to a contact group.

    Args:
        group_resource_name: Contact group resource name
        contact_resource_names: List of contact resource names to add

    Returns:
        Result dictionary with any errors
    """
    try:
        modify_body = {"resourceNamesToAdd": contact_resource_names}

        response = (
            self.service.contactGroups()
            .members()
            .modify(resourceName=group_resource_name, body=modify_body)
            .execute()
        )

        return {
            "success": True,
            "added_count": len(contact_resource_names),
            "not_found": response.get("notFoundResourceNames", []),
            "could_not_add": response.get("canNotRemoveLastContactGroupResourceNames", []),
        }

    except HttpError as error:
        raise GoogleContactsError(f"Error adding contacts to group: {error}")

MCP Google Contacts Server