Skip to content
Get packs

Google People Contacts

Lets the agent read, search, create, update and delete Google Contacts via the gws CLI.

Source Download skill
Repository
googleworkspace/cli
Stars
32,059
Licence
Apache-2.0
Files
1 file

What it does

Once installed, the agent can work with your Google Contacts through the gws command-line tool. It can list and search your contacts and contact groups, look up people in your organisation's directory, and create, edit, or delete contacts and their photos. It relies on the gws tool to be installed and authenticated, and it points to a shared skill file for login and security rules.

Great for

  • People who want an AI assistant to tidy up, deduplicate or bulk-edit their Google Contacts
  • Google Workspace administrators or users who need to search the company directory
  • Developers building contact-management workflows on the Google People API

Skip it if

  • Anyone who does not want an agent to change their address book: create, update and delete calls modify real contact data and cannot be assumed reversible
  • Users without the gws CLI installed and authenticated, since the skill cannot work without it
  • Non-Google contact systems, because this only covers Google People API

Try asking

  • “Search my Google Contacts for everyone at Acme Corp and list their email addresses”
  • “Create contact groups for 'Book Club' and add the people I have emailed most often”
  • “Update the phone number for Jane Smith in my contacts to +44 20 7946 0000”
  • “Show me the contacts in my domain directory that match 'finance'”
Step-by-step guide: how to use Google People ContactsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    gws-people.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip gws-people.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip gws-people.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run 'gws schema people.<resource>.<method>' first so the agent builds correct flags, and review create, update and delete commands before they run
  • Ask the agent to search or list before editing, so it can confirm the exact contact resource names it will change
  • Back up your contacts (export from Google Contacts) before any bulk update or delete operation

What's inside

  • SKILL.md

Redistributed unmodified from googleworkspace/cli under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.