Conecte o Chatfuel MCP ao Gmail MCP
Quando alguém no WhatsApp ou no Instagram pede detalhes por e-mail, um rascunho personalizado para essa pessoa fica no seu Gmail, pronto para revisar e enviar. Na mesma conversa com o assistente, as respostas que a equipe já deu por e-mail vão para o FAQ do Agente de IA, e o e-mail de uma cliente ajuda você a responder na conversa dela. O servidor do Gmail está em Developer Preview e só cria rascunhos, então cada e-mail sai quando você clica em Enviar.
O que a integração faz
As tools que o assistente usa em cada lado, com os nomes que cada servidor dá a elas.
| Tool | O que faz |
|---|---|
list_chats | Lista as conversas com clientes com canal, status e etapa do lead. |
get_chat | Mostra as últimas mensagens de uma conversa com um cliente, com canal, status e etapa do lead. |
update_automation_setting | Muda uma configuração de uma automação: quando a IA responde, a passagem para a equipe, os follow-ups, a qualificação de leads, as regras de agendamento ou as respostas a comentários. |
review_chats | Resume as conversas com clientes de um período em vez de devolver cada mensagem. |
get_knowledge_base | Mostra o que o Agente de IA usa para responder: dados da empresa, instruções, horário de atendimento, FAQ, serviços e profissionais. |
add_faq | Adiciona perguntas e respostas ao FAQ que o Agente de IA usa para responder. |
test_reply | Envia uma mensagem de cliente de teste para uma conversa de teste e devolve a resposta do Agente de IA. |
send_chat_message | Envia ao cliente, na conversa dele, o texto que você aprovou e passa a conversa para o chat ao vivo. |
return_chat_to_ai | Devolve ao Agente de IA uma conversa que está no chat ao vivo, depois do seu sim, e o Agente de IA responde a última mensagem do cliente. |
list_bookings | Lista os agendamentos entre duas datas: horário, serviço, profissional, nome do cliente e status. |
| Tool | O que faz |
|---|---|
search_threads | Pesquisa na sua caixa de e-mail com operadores de busca do Gmail como from:, to:, in:sent ou newer_than: e devolve conversas de e-mail com assunto e um trecho. |
get_thread | Mostra todas as mensagens de uma conversa de e-mail, com remetente, destinatários, data e texto completo. |
create_draft | Salva um e-mail novo nos Rascunhos com destinatários, assunto e texto, ou como resposta a uma mensagem existente. Nunca envia nada. |
list_drafts | Lista os rascunhos da sua conta, com filtro opcional por uma busca como to: e um endereço. |
list_labels | Lista os marcadores que você criou no Gmail com os IDs, que as outras ferramentas de marcadores e as buscas com label: precisam. |
label_thread | Aplica um ou mais marcadores a uma conversa de e-mail inteira, inclusive às mensagens que chegarem depois. |
O que pedir ao assistente
Pediu os detalhes por e-mail no chat → um rascunho no Gmail para cada cliente
QuandoMuita gente pergunta ao Agente de IA sobre o pacote com 3 Hidratações faciais (R$ 480) e quer receber os detalhes por e-mail, para ler com calma ou mostrar para alguém. Esses e-mails quase nunca são escritos: se perdem entre uma conversa e outra.
- O Chatfuel MCP liga a coleta de contato com
update_automation_setting: quando alguém quer os detalhes por e-mail, o Agente de IA pede o endereço e salva num atributo de e-mail. - No fim do dia,
list_chatstraz as conversas recentes eget_chatlê cada uma. O assistente fica com as que têm um e-mail digitado pelo cliente e uma pergunta sobre o pacote. - O Gmail MCP confere com
search_threads, usando to: e esse endereço, se alguém da equipe já escreveu para a pessoa e deixa esses casos de fora. create_draftescreve um e-mail por cliente: o preço do pacote, o que as três sessões incluem, como agendar e uma linha sobre o que ela perguntou no chat.
ResultadoNos Rascunhos fica um e-mail personalizado para cada cliente, e você envia pelo Gmail depois de ler. O servidor do Gmail não tem ferramenta de envio, então nada chega a ninguém antes de você clicar em Enviar. Pela referência do Google, rascunhos ainda não aceitam anexos: coloque no texto um link para a tabela de preços.
PeçaEncontre as conversas de hoje no Chatfuel em que um cliente deixou o e-mail e perguntou sobre o pacote com 3 Hidratações faciais. Pule quem já recebeu e-mail nosso e crie no Gmail um rascunho personalizado para cada um dos outros.

O que a equipe responde por e-mail → o FAQ do Agente de IA
QuandoAlguns clientes escrevem para o Gmail da clínica em vez do chat, e a Camila Alves responde por lá: nota fiscal para empresa, atendimento para adolescentes. No WhatsApp e no Instagram, o Agente de IA continua sem essas respostas.
- O Chatfuel MCP analisa o último mês com
review_chats, que, entre outras coisas, devolve as perguntas de clientes que nenhuma entrada do FAQ cobre. - O Gmail MCP procura cada assunto nos enviados com
search_threads(in:sent newer_than:90d), eget_threadlê como a Camila respondeu. add_faqtransforma em entradas do FAQ as respostas que você aprovar, etest_replyfaz uma das perguntas ao Agente de IA numa conversa de teste.list_labelsencontra o marcador No FAQ que você criou no Gmail, elabel_threadaplica esse marcador às conversas de e-mail usadas, para a próxima busca pular todas com -label.
ResultadoO Agente de IA responde no chat com as palavras que a Camila já escolheu por e-mail, e a sua caixa mostra quais conversas de e-mail já viraram FAQ. Os marcadores pedem o escopo gmail.modify, que a página de configuração do Google não adiciona.
PeçaEncontre as perguntas que o FAQ do Chatfuel ainda não cobre, veja como a Camila respondeu nos enviados do Gmail dos últimos 90 dias e adicione essas respostas ao FAQ. Depois aplique o marcador No FAQ às conversas de e-mail que você usou.

"Mandei um e-mail", diz a cliente no chat → a resposta vem do e-mail
QuandoUma cliente escreve no Instagram que mandou fotos da pele para o e-mail da clínica na semana passada e quer saber o que a Camila acha. O Agente de IA não enxerga a sua caixa de entrada.
- O Chatfuel MCP adiciona uma regra de passagem com
update_automation_setting: quando uma cliente fala de um e-mail que enviou, o Agente de IA avisa que a equipe vai verificar e passa a conversa adiante. list_chatsmostra as conversas esperando uma pessoa, eget_chatlê a mensagem dela e o endereço que ela digitou.- O Gmail MCP acha o e-mail dela com
search_threads, usando from: e esse endereço, eget_threadlê a mensagem e a resposta da Camila: começar pela Hidratação facial, não pelo Peeling. send_chat_messageenvia a resposta curta que você aprovar, ereturn_chat_to_aidevolve a conversa depois do seu sim, para o Agente de IA agendar a sessão.
ResultadoEla recebe a orientação da Camila na mesma conversa de onde escreveu, e ninguém copia texto de um app para outro. O Instagram aceita a sua resposta até 7 dias depois da última mensagem dela; o WhatsApp, até 24 horas. Se ela não digitou endereço nenhum, o assistente pergunta a você qual é o e-mail dela.
PeçaEncontre as conversas do Chatfuel esperando a gente em que uma cliente fala de um e-mail que mandou. Leia no Gmail a conversa de e-mail com a resposta da Camila e escreva uma resposta curta para o chat. Quando eu enviar, devolva a conversa ao Agente de IA.

As sessões de ontem → e-mails de cuidados iguais ao que o chat diz
QuandoDepois de um Peeling ou de uma Hidratação facial, as clientes fazem no chat as mesmas perguntas de cuidados, e a Camila quer que cada uma receba as orientações por escrito, por e-mail, na manhã seguinte.
- O Chatfuel MCP traz os agendamentos de ontem com
list_bookingse fica com os Peelings e Hidratações faciais em que a cliente compareceu: horário, serviço, profissional e nome da cliente. get_knowledge_baselê as respostas de cuidados do FAQ. As que faltarem,add_faqadiciona depois do seu sim, para o chat e o e-mail dizerem a mesma coisa.list_chatsencontra a conversa de cada cliente pelo nome, eget_chatprocura o e-mail que ela digitou ao agendar.- O Gmail MCP confere com
list_draftsse já existe um rascunho de cuidados para esse endereço, ecreate_draftescreve um por cliente com as orientações do tratamento dela.
ResultadoAs clientes que deixaram e-mail recebem os cuidados com as suas palavras assim que você envia os rascunhos, e o Agente de IA dá as mesmas respostas quando elas perguntam no chat. Os agendamentos do Chatfuel não trazem e-mail, então o assistente lista para você quem nunca digitou um.
PeçaVeja no Chatfuel os Peelings e Hidratações faciais de ontem em que a cliente compareceu, garanta que o FAQ tenha respostas de cuidados para os dois e crie no Gmail um e-mail de cuidados para cada cliente que digitou o e-mail na conversa.

Como conectar
Entre na preview do Google
O servidor MCP do Gmail só atende contas do Google Workspace Developer Preview Program. Inscreva-se com a sua conta do Workspace e um projeto do Cloud; o Google registra os dois e confirma por e-mail, em geral em um ou dois dias.
Prepare o projeto do Cloud
Ative a Gmail API e a Gmail MCP API, adicione os escopos gmail.readonly e gmail.compose na tela de consentimento (e gmail.modify para marcadores) e crie um cliente do tipo Web application marcado com Use this client for an AI-powered agent.
Adicione os dois servidores e peça
O Chatfuel entra pelo diretório do Claude ou do ChatGPT, ou por https://mcp.chatfuel.com/panel no Cursor. O Gmail entra por https://gmailmcp.googleapis.com/mcp/v1 com o client ID e o secret do seu cliente. O Chatfuel pede um sim antes de cada mudança no bot e de cada mensagem a um cliente.
- Conecte o Chatfuel pelo diretório de conectores do Claude e faça login.
- O diretório do Claude também tem um conector do Gmail feito pelo Google, mas a ajuda do Claude diz que ele só pesquisa e lê e-mails. Para rascunhos e marcadores, adicione o Gmail como conector personalizado.
- Coloque https://claude.ai/api/mcp/auth_callback como URI de redirecionamento no seu cliente OAuth do Google. Depois abra Settings › Connectors (Admin settings › Connectors no Team e no Enterprise), clique em Add custom connector, dê o nome Gmail e cole https://gmailmcp.googleapis.com/mcp/v1.
- Informe o client ID e o secret em Advanced settings, clique em Add e entre com a conta do Google que está na preview. O Google indica Claude Pro, Max, Team ou Enterprise para isso.
- Chatfuel MCP
- claude.ai/directory/chatfuel
- Gmail MCP
https://gmailmcp.googleapis.com/mcp/v1
- Adicione o plugin do Chatfuel pelo diretório do ChatGPT e faça login.
- O Google não dá passos do ChatGPT para o Gmail. Ative o Developer mode, abra Plugins, clique em + e escolha Add custom MCP server com a URL https://gmailmcp.googleapis.com/mcp/v1.
- Escolha OAuth e informe o client ID e o secret do Google: o Google não registra clientes automaticamente.
- Copie a URL de redirecionamento que o ChatGPT mostra para o cliente no Google Cloud, crie o plugin e entre com o Google.
- Chatfuel MCP
- chatgpt.com/plugins
- Gmail MCP
https://gmailmcp.googleapis.com/mcp/v1
- Adicione o Chatfuel ao ~/.cursor/mcp.json com a URL https://mcp.chatfuel.com/panel.
- No Google Cloud, permita http://localhost:8787/callback no seu cliente para agentes para o app de desktop, e https://www.cursor.com/agents/mcp/oauth/callback se você usa o Cursor na web.
- Adicione um servidor gmail com "url": "https://gmailmcp.googleapis.com/mcp/v1" e um bloco auth com CLIENT_ID, CLIENT_SECRET e os escopos gmail.readonly e gmail.compose, mais gmail.modify para marcadores.
- Entre no Google na primeira vez que o Cursor chamar uma ferramenta do Gmail.
- Chatfuel MCP
https://mcp.chatfuel.com/panel- Gmail MCP
https://gmailmcp.googleapis.com/mcp/v1
O que você precisa
- Um bot do Chatfuel com o Agente de IA atendendo clientes no WhatsApp, Instagram, Facebook, TikTok ou chat do site. O caso dos cuidados pós-sessão também precisa dos agendamentos configurados, para o Agente de IA marcar sessões.
- Uma conta do Google Workspace e um projeto do Cloud aceitos no Google Workspace Developer Preview Program, que o Gmail MCP exige.
- Nesse projeto: a Gmail API e a Gmail MCP API ativas, uma tela de consentimento OAuth e um cliente OAuth do tipo Web application com Use this client for an AI-powered agent marcado. Desde 11 de novembro de 2026, os servidores MCP do Workspace recusam clientes sem essa marcação.
- Os escopos gmail.readonly e gmail.compose para ler e-mails e criar rascunhos, e gmail.modify para as etapas com marcadores.
- Claude Pro, Max, Team ou Enterprise, ChatGPT com Developer mode, ou Cursor, conectado à conta do Gmail de onde a equipe responde os clientes.
Limites
- O Gmail MCP é uma Developer Preview. Pelos termos do programa, o Google oferece o servidor no estado em que está, não permite usuários fora da sua empresa antes do GA e pode usar os dados enviados por ele para melhorar a API.
- O Google não documenta nenhuma ferramenta que envie e-mail. O assistente cria rascunhos, e alguém da equipe envia cada um pelo Gmail.
- Pela referência do create_draft do Google, rascunhos ainda não aceitam anexos. Coloque no texto um link para a tabela de preços ou para a folha de cuidados.
- O Chatfuel mostra nomes, não e-mails, em conversas e agendamentos, e list_chats não pesquisa por e-mail. Só existe endereço se o cliente digitou na conversa, e ligar uma conversa a um e-mail depende dele.
- O conector do Gmail do diretório do Claude é somente leitura, segundo a ajuda do Claude. Rascunhos e marcadores precisam do conector personalizado com o seu próprio cliente OAuth.
- Um e-mail pode trazer instruções escondidas. O Google pede para verificar prompts e respostas contra injeção, com o Model Armor ou uma ferramenta sua, e revisar cada ação do assistente. Sem acesso offline, o Google também pede login de novo mais ou menos a cada hora.
Perguntas frequentes
Sim. O Google hospeda o servidor em https://gmailmcp.googleapis.com/mcp/v1, com Streamable HTTP, como um dos servidores MCP do Google Workspace, com o selo Developer Preview. Ele não está no MCP Registry e ainda não tem disponibilidade geral.
Não com as ferramentas que o Google documenta. create_draft salva o e-mail nos Rascunhos, e você revisa e envia pelo Gmail. Mensagens no WhatsApp ou no Instagram só saem pelo send_chat_message do Chatfuel, depois do seu sim ao texto exato.
Aceite os termos do programa e envie o formulário do Google com a sua conta do Workspace e os dados do projeto do Cloud. O Google adiciona o seu e-mail ao Google Group do programa, registra o projeto e confirma por e-mail, em geral em um ou dois dias. A inscrição libera todos os recursos em preview, não só o Gmail.
O diretório do Claude lista o Gmail, feito pelo Google, mas a ajuda do Claude diz que esse conector não cria, não envia e não altera e-mails. Para rascunhos e marcadores, é preciso o conector personalizado do Google com o seu próprio cliente OAuth e os escopos gmail.compose e gmail.modify.
Só da conversa. O Chatfuel MCP devolve nomes, canais e mensagens, não campos de contato, então o assistente procura um endereço que o cliente digitou. Ligue a coleta de contato para o Agente de IA pedir o e-mail quando alguém quer detalhes por e-mail.
Não. Nada roda em segundo plano entre os dois servidores. O assistente pesquisa no Gmail e atualiza o Chatfuel, ou cria rascunhos, só quando você pede no chat.
Mais integrações
Conecte o Chatfuel MCP
Comece o teste grátis, adicione o Chatfuel ao seu assistente e pergunte sobre Gmail e as suas conversas em um só lugar.

