GSuite

Interaja com produtos Google, incluindo Gmail e Calendário.

GitHub
3
Experimente este MCPPatrocinado

Documentação

mcp-gsuite servidor MCP

smithery badge Servidor MCP para interagir com produtos Google.

Exemplos de prompts

Atualmente, este servidor MCP suporta integração com Gmail e Calendar com os seguintes recursos:

  1. Geral
  • Múltiplas contas do Google
  1. Gmail
  • Obtenha informações do seu usuário do Gmail
  • Consulte e-mails com busca flexível (por exemplo, não lidos, de remetentes específicos, intervalos de datas, com anexos)
  • Recupere o conteúdo completo do e-mail por ID
  • Crie novos rascunhos de e-mail com destinatários, assunto, corpo e opções de CC
  • Exclua rascunhos de e-mails
  • Responda a e-mails existentes (pode enviar imediatamente ou salvar como rascunho)
  • Recupere vários e-mails de uma vez por seus IDs.
  • Salve vários anexos de e-mails no seu sistema local.
  1. Calendar
  • Gerencie vários calendários
  • Obtenha eventos de calendário em intervalos de tempo especificados
  • Crie eventos de calendário com:
    • Título, horários de início/fim
    • Local e descrição opcionais
    • Participantes opcionais
    • Suporte a fuso horário personalizado
    • Preferências de notificação
  • Exclua eventos de calendário

Exemplos de prompts que você pode experimentar:

  • Recupere minhas mensagens não lidas mais recentes

  • Pesquise meus e-mails do Scrum Master

  • Recupere todos os e-mails do departamento de contabilidade

  • Pegue o e-mail sobre ABC e resuma-o

  • Escreva uma resposta educada para o último e-mail de Alice e salve um rascunho.

  • Responda ao e-mail de Bob com uma nota de agradecimento. Salve como rascunho

  • O que tenho na minha agenda amanhã?

  • Verifique a agenda da Família da minha conta privada para a próxima semana

  • Preciso planejar um evento com Tim por 2 horas na próxima semana. Sugira alguns horários.

Início rápido

Instalar

Instalando via Smithery

Para instalar a Integração G Suite para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @alBERT-launcher/mcp-gsuite --client claude

Oauth 2

As APIs do Google Workspace (G Suite) exigem autorização OAuth2. Siga estas etapas para configurar a autenticação:

  1. Crie credenciais OAuth2:

    • Acesse o Google Cloud Console
    • Crie um novo projeto ou selecione um existente
    • Ative a API do Gmail e a API do Google Calendar para o seu projeto
    • Vá para "Credenciais" → "Criar credenciais" → "ID do cliente OAuth"
    • Selecione "Aplicativo de desktop" ou "Aplicativo web" como tipo de aplicativo
    • Configure a tela de consentimento OAuth com as informações necessárias
    • Adicione URIs de redirecionamento autorizados (inclua http://localhost:4100/code para desenvolvimento local)

  2. Escopos OAuth2 necessários:

   [
     "openid",
     "https://mail.google.com/",
     "https://www.googleapis.com/auth/calendar",
     "https://www.googleapis.com/auth/userinfo.email"
   ]
  1. Em seguida, crie um .gauth.json no seu diretório de trabalho com o cliente
{
    "web": {
        "client_id": "$your_client_id",
        "client_secret": "$your_client_secret",
        "redirect_uris": ["http://localhost:4100/code"],
        "auth_uri": "https://accounts.google.com/o/oauth2/auth",
        "token_uri": "https://oauth2.googleapis.com/token"
    }
}
  1. Crie um arquivo .accounts.json com informações da conta
{
    "accounts": [
        {
            "email": "alice@bob.com",
            "account_type": "personal",
            "extra_info": "Additional info that you want to tell Claude: E.g. 'Contains Family Calendar'"
        }
    ]
}

Você pode especificar várias contas. Certifique-se de que elas tenham acesso no seu aplicativo Google Auth. O campo extra_info é especialmente interessante, pois você pode adicionar informações aqui que deseja informar à IA sobre a conta (por exemplo, se ela tem uma agenda específica)

Nota: Quando você executar pela primeira vez uma das ferramentas para uma conta específica, um navegador será aberto, redirecionará você para o Google e solicitará suas credenciais, escopo, etc. Após um login bem-sucedido, ele armazena as credenciais em um arquivo local chamado .oauth.{email}.json . Depois de autorizado, o token de atualização será usado.

Claude Desktop

No MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

No Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuração de Servidores de Desenvolvimento/Não Publicados 
{
  "mcpServers": {
    "mcp-gsuite": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-gsuite",
        "run",
        "mcp-gsuite"
      ]
    }
  }
}
Configuração de Servidores Publicados 
{
  "mcpServers": {
    "mcp-gsuite": {
      "command": "uvx",
      "args": [
        "mcp-gsuite"
      ]
    }
  }
}

Opções de Configuração

O servidor MCP pode ser configurado com várias opções de linha de comando para especificar caminhos personalizados para autenticação e informações de conta:

  • --gauth-file: Especifica o caminho para o arquivo .gauth.json contendo a configuração do cliente OAuth2. O padrão é ./.gauth.json.
  • --accounts-file: Especifica o caminho para o arquivo .accounts.json contendo informações sobre as contas do Google. O padrão é ./.accounts.json.
  • --credentials-dir: Especifica o diretório onde as credenciais OAuth são armazenadas após a autenticação bem-sucedida. O padrão é o diretório de trabalho atual com um subdiretório para cada conta como .oauth.{email}.json.

Essas opções permitem flexibilidade no gerenciamento de diferentes ambientes ou múltiplos conjuntos de credenciais e contas, especialmente úteis em cenários de desenvolvimento e teste.

Exemplo de uso:

uv run mcp-gsuite --gauth-file /path/to/custom/.gauth.json --accounts-file /path/to/custom/.accounts.json --credentials-dir /path/to/custom/credentials

Essa configuração é particularmente útil quando você tem várias instâncias do servidor em execução com configurações diferentes ou ao implantar em ambientes onde os caminhos padrão não são adequados.

Desenvolvimento

Compilação e Publicação

Para preparar o pacote para distribuição:

  1. Sincronize as dependências e atualize o lockfile:
uv sync
  1. Compile as distribuições do pacote:
uv build

Isso criará distribuições de origem e wheel no diretório dist/.

  1. Publique no PyPI:
uv publish

Nota: Você precisará definir as credenciais do PyPI por meio de variáveis de ambiente ou sinalizadores de comando:

  • Token: --token ou UV_PUBLISH_TOKEN
  • Ou nome de usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD

Depuração

Como os servidores MCP são executados via stdio, a depuração pode ser desafiadora. Para a melhor experiência de depuração, recomendamos fortemente o uso do MCP Inspector.

Você pode iniciar o MCP Inspector via npm com este comando:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite

Ao iniciar, o Inspector exibirá uma URL que você pode acessar no seu navegador para começar a depurar.

Você também pode observar os logs do servidor com este comando:

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log