gws-people
Faz seu agente gerenciar contatos e perfis no Google People. Ajuda a organizar informações de pessoas e relacionamentos.
O que ela faz
Esta ferramenta permite gerenciar seus contatos e perfis. Você pode criar, listar, atualizar e excluir grupos de contatos, além de adicionar ou remover pessoas desses grupos.
Quando usar
- ✓Criar um novo grupo de contatos para organizar seus contatos.
- ✓Adicionar um contato a um grupo existente.
- ✓Buscar um contato específico na sua lista.
Exemplo do que pedir para a IA
“Crie um grupo de contatos chamado 'Família' e adicione o João Silva a ele.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A ferramenta se conecta à sua conta Google para acessar e modificar seus contatos. Ela usa comandos específicos para cada ação, como criar, listar ou deletar.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add googleworkspace/cli --skill gws-peopleOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-people/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
people (v1)
PRÉ-REQUISITO: Leia
../gws-shared/SKILL.mdpara autenticação, flags globais e regras de segurança. Se estiver faltando, executegws generate-skillspara criá-lo.
gws people <resource> <method> [flags]
Recursos da API
contactGroups
batchGet— Obtém uma lista de grupos de contatos pertencentes ao usuário autenticado, especificando uma lista de nomes de recursos de grupos de contatos.create— Cria um novo grupo de contatos pertencente ao usuário autenticado. Os nomes dos grupos de contatos criados devem ser únicos entre os grupos de contatos do usuário. Tentar criar um grupo com um nome duplicado retornará um erro HTTP 409. Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.delete— Exclui um grupo de contatos existente pertencente ao usuário autenticado, especificando um nome de recurso de grupo de contatos. Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.get— Obtém um grupo de contatos específico pertencente ao usuário autenticado, especificando um nome de recurso de grupo de contatos.list— Lista todos os grupos de contatos pertencentes ao usuário autenticado. Os membros dos grupos de contatos não são populados.update— Atualiza o nome de um grupo de contatos existente pertencente ao usuário autenticado. Os nomes dos grupos de contatos atualizados devem ser únicos entre os grupos de contatos do usuário. Tentar criar um grupo com um nome duplicado retornará um erro HTTP 409. Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.members— Operações no recurso 'members'
otherContacts
copyOtherContactToMyContactsGroup— Copia um "Outro contato" para um novo contato no grupo "meusContatos" do usuário. Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.list— Lista todos os "Outros contatos", ou seja, contatos que não estão em um grupo de contatos. "Outros contatos" são tipicamente contatos criados automaticamente a partir de interações. Tokens de sincronização expiram 7 dias após a sincronização completa. Uma requisição com um token de sincronização expirado receberá um erro com um google.rpc.ErrorInfo com a razão "EXPIRED_SYNC_TOKEN". Nesse caso, os clientes devem fazer uma requisição de sincronização completa sem umsync_token.search— Fornece uma lista de contatos nos outros contatos do usuário autenticado que correspondem à consulta de pesquisa. A consulta corresponde aos camposnames,emailAddressesephoneNumbersde um contato que são da origem OTHER_CONTACT. IMPORTANTE: Antes de pesquisar, os clientes devem enviar uma requisição de aquecimento com uma consulta vazia para atualizar o cache. Veja https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts
people
batchCreateContacts— Cria um lote de novos contatos e retorna as PersonResponses para os novos contatos. Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.batchUpdateContacts— Atualiza um lote de contatos e retorna um mapa de nomes de recursos para PersonResponses para os contatos atualizados. Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.createContact— Cria um novo contato e retorna o recurso de pessoa para esse contato. A requisição retorna um erro 400 se mais de um campo for especificado em um campo que é um singleton para fontes de contato: * biografias * aniversários * gêneros * nomes Requisições de mutação para o mesmo usuário devem ser enviadas sequencialmente para evitar aumento de latência e falhas.deleteContactPhoto— Exclui a foto de um contato. Requisições de mutação para o mesmo usuário devem ser feitas sequencialmente para evitar // contenção de bloqueio.get— Fornece informações sobre uma pessoa especificando um nome de recurso. Usepeople/mepara indicar o usuário autenticado. A requisição retorna um erro 400 se 'personFields' não for especificado.getBatchGet— Fornece informações sobre uma lista de pessoas específicas, especificando uma lista de nomes de recursos solicitados. Usepeople/mepara indicar o usuário autenticado. A requisição retorna um erro 400 se 'personFields' não for especificado.
…
Perguntas frequentes
Como faço para ver todos os meus grupos de contatos?
Use o comando 'list' na seção 'contactGroups'.
Posso renomear um grupo de contatos?
Sim, use o comando 'update' na seção 'contactGroups' e forneça o novo nome.
Como adiciono um contato a um grupo?
Você pode usar o comando 'create' na seção 'members' para adicionar um contato a um grupo existente.
Detalhes
Popularidade
- Estrelas no GitHub
- 32 mil
- Posição no ranking
- #6279
- Licença
- Apache-2.0
- Atualizada em
- 06/10/2026
Comentários
- …
Mais skills deste repositório
gws-admin-reports
Ajuda seu agente a obter relatórios de atividades do Google Workspace. Ele coleta dados de auditoria e uso.
googleworkspace/cli
gws-calendar-agenda
Ajuda seu agente a ver eventos futuros em todos os calendários. É útil para organizar sua agenda e saber o que está por vir.
googleworkspace/cli
gws-calendar-insert
Faz seu agente criar novos eventos no Google Agenda. É útil para agendar compromissos e reuniões.
googleworkspace/cli
gws-calendar
Permite que seu agente gerencie calendários e eventos. É útil para organizar sua vida e trabalho.
googleworkspace/cli
Skills parecidas
google-workspace-ops
Opera com documentos do Google Workspace (Drive, Docs, Sheets, Slides) como um fluxo de trabalho unificado. Facilita encontrar, resumir e editar seus arquivos sem sair da ferramenta.
affaan-m/ECC
Dynamics 365 Automation
Ajuda seu agente a gerenciar informações de clientes no Dynamics 365. Ele pode lidar com contatos, vendas e casos, tornando o trabalho mais organizado.
ComposioHQ/awesome-claude-skills
Excel Automation
Ajuda seu agente a trabalhar com planilhas no Excel e Google Sheets. Ele pode criar, editar e formatar arquivos.
ComposioHQ/awesome-claude-skills