Como integrar Gmail usando MCP
Search and read Gmail mailbox data. Este guia cria um servidor MCP a partir do template Gmail do Arthur — ferramentas pré-configuradas contra https://gmail.googleapis.com/gmail/v1 — e termina compartilhando a documentação swagger MCP do servidor.
Passos
Abra o Cofre de segredos e crie um segredo chamado
CHAVE_GMAILcom a sua token de acesso. Enable the Gmail API in a Google Cloud project, complete the OAuth 2.0 consent flow with the narrowest required Gmail scope, and provide the resulting access token as a Bearer token. Reading message content normally requires the restricted gmail.readonly scope and may trigger Google verification requirements.


Acesse a galeria REST API Templates e busque por Gmail.


Clique em Usar template no card Gmail para abrir o diálogo de criação de servidor.


Revise o nome do servidor e selecione
CHAVE_GMAILno campo de credencial — o diálogo só aceita secrets do cofre, e lista todas as ferramentas que serão criadas.






Clique em Criar servidor. O Arthur cria o servidor, aplica a autenticação e gera todas as ferramentas.
Abra a aba Ferramentas do servidor para revisar as ferramentas geradas.


Abra a seção Conectar do servidor e clique em Compartilhar com cliente — o Arthur gera o link público da documentação swagger e o QR code deste servidor.



Confirme que funcionou
O servidor aparece com 4 ferramenta(s) pré-configurada(s): get_profile, list_messages, get_message, list_labels. A seção Conectar oferece a documentação swagger MCP — uma página compartilhável com instruções de configuração para qualquer cliente de IA.
Bom saber
- Inspect the authenticated Gmail user's mailbox profile, search and retrieve messages, and list mailbox labels through the official Gmail API.
- Esta integração exige uma credencial (bearer). Obtenha a sua em https://console.cloud.google.com/.
- Documentação oficial da API: https://developers.google.com/workspace/gmail/api/reference/rest
- Editar uma ferramenta depois nunca altera o template — templates são pontos de partida, e o servidor é totalmente seu após a criação.
Relacionado
Vídeo tutorial