recipe-sync-contacts-to-sheet — Claude skill: export contacts
This skill pulls your Google Contacts directory into a Google Sheets spreadsheet, writing a header row and one row per contact.
npx skills add googleworkspace/cli --skill recipe-sync-contacts-to-sheet -a claude-codeWhat recipe-sync-contacts-to-sheet does
The skill runs through the gws CLI. First it lists directory people with people listDirectoryPeople, using the read mask names,emailAddresses,phoneNumbers and the DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE source, 100 records per page. Then it creates a Contacts sheet with headers and appends each contact row.
Three steps, two dependencies. The recipe needs the gws-people and gws-sheets skills loaded, and the gws binary on your machine. You supply the SHEET_ID yourself.
Worth installing if you move a company directory into a sheet on a schedule and would rather not click through the admin UI. For a one-off export, or if you need a different format, skip it.
What it helps with
- dump a company contact directory into a spreadsheet
- collect names, emails and phone numbers in one command
- refresh the Contacts sheet with current directory data
- hand colleagues contacts in Google Sheets instead of a CSV export
- append new rows to an existing sheet
Example prompts for the agent
- Export the contacts directory to spreadsheet SHEET_ID, sheet Contacts
- Show the first 100 contacts from the domain directory
- Append a row for a new employee to the Contacts sheet
How to install recipe-sync-contacts-to-sheet
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill recipe-sync-contacts-to-sheet -a claude-code2Manually: put the files in place
~/.claude/skills/recipe-sync-contacts-to-sheet/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/recipe-sync-contacts-to-sheet/
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill recipe-sync-contacts-to-sheet -a codex2Manually: put the files in place
.agents/skills/recipe-sync-contacts-to-sheet/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill recipe-sync-contacts-to-sheet -a cursor2Manually: put the files in place
.cursor/skills/recipe-sync-contacts-to-sheet/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install googleworkspace/cli recipe-sync-contacts-to-sheet2Manually: put the files in place
.github/skills/recipe-sync-contacts-to-sheet/SKILL.md1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill recipe-sync-contacts-to-sheet -a gemini-cli2Platform CLI
gemini skills install https://github.com/googleworkspace/cli --path skills/recipe-sync-contacts-to-sheetManually: put the files in place
.devin/skills/recipe-sync-contacts-to-sheet/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill recipe-sync-contacts-to-sheet -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set95
The whole set →Similar
Questions about recipe-sync-contacts-to-sheet
How do I install recipe-sync-contacts-to-sheet in Claude?
Run npx skills add googleworkspace/cli --skill recipe-sync-contacts-to-sheet -a claude-code. The skill file lands at ~/.claude/skills/recipe-sync-contacts-to-sheet/SKILL.md.
What does recipe-sync-contacts-to-sheet do?
It reads the Google Contacts directory via gws people listDirectoryPeople and writes the contacts into Google Sheets: headers first, then rows with name, email and phone.
What do I need before running the skill?
The gws binary plus the gws-people and gws-sheets skills. You also need the SHEET_ID of the target spreadsheet.
Source text
SKILL.md · Apache-2.0
---
name: recipe-sync-contacts-to-sheet
description: "Export Google Contacts directory to a Google Sheets spreadsheet."
metadata:
version: 0.22.5
openclaw:
category: "recipe"
domain: "productivity"
requires:
bins:
- gws
skills:
- gws-people
- gws-sheets
---
# Export Google Contacts to Sheets
> **PREREQUISITE:** Load the following skills to execute this recipe: `gws-people`, `gws-sheets`
Export Google Contacts directory to a Google Sheets spreadsheet.
## Steps
1. List contacts: `gws people people listDirectoryPeople --params '{"readMask": "names,emailAddresses,phoneNumbers", "sources": ["DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE"], "pageSize": 100}' --format json`
2. Create a sheet: `gws sheets +append --spreadsheet SHEET_ID --range 'Contacts' --values '["Name", "Email", "Phone"]'`
3. Append each contact row: `gws sheets +append --spreadsheet SHEET_ID --range 'Contacts' --values '["Jane Doe", "[email protected]", "+1-555-0100"]'`
© googleworkspace · Apache-2.0 · googleworkspace/cli