Google Contacts: Create a contact — MCP tool
Google Contacts MCP tool: Creates one new contact in the user's Google Contacts from normalized fields.
Technical name: create_contact
What task it solves
I want to add a new contact.
Creates one contact from normalized fields (name, emails, phones, addresses, organization, birthday, notes, urls) and returns the created person.
When to use it
Use it to save a single new person. For importing many people, use Create many contacts instead — one request instead of N.
What to provide
At least one contact field: given_name, family_name, middle_name, prefix, suffix, nickname, emails[], phones[], addresses[], organization, birthday (YYYY-MM-DD or MM-DD), notes, urls[]. Optional person_fields picks the returned fields.
What it returns
The created person — save its resourceName (people/c...) to update, group or delete it later.
What changes in Google Contacts
A new contact appears in the user's saved contacts immediately.
Example request
Add Ada Lovelace, ada@example.com, +1 555 0100, company "Analytical Engines".
Errors and limitations
The API does not deduplicate: calling twice with the same data creates two contacts — after a timeout or 5xx, check with search or list before re-sending (writes are never auto-retried). Contact photos cannot be set here (raw_request → :updateContactPhoto). Access also depends on token permissions, quotas, and upstream API limits.
Related MCP tools
- Create many contacts —
batch_create_contacts - Update a contact —
update_contact - Add/remove group members —
modify_group_members
Technical details
- Impact: changes data
- Group: Contacts
- Description source:
create_contactregistration insrc/tools/contacts.ts - Full technical reference
- All MCP capabilities