O Google Workspace oferece servidores remotos do Protocolo de Contexto de Modelo (MCP) que permitem que agentes de IA interajam com segurança com os dados do Google Workspace. Ao configurar os servidores MCP do Google Workspace, você permite que aplicativos de IA, como o Google Antigravity e o Claude, realizem ações em aplicativos do Google Workspace, como Gmail, Google Drive, Google Docs, Google Planilhas, Google Slides, Google Agenda, Google Chat e Google Sala de Aula. Cada produto do Google Workspace tem um servidor MCP dedicado.
Os servidores MCP do Google Workspace oferecem uma maneira padronizada para os agentes de IA:
- Ler dados: pesquise e-mails, recupere arquivos e liste eventos da agenda.
- Entre em ação: crie rascunhos de e-mails, faça upload de arquivos e agende reuniões.
- Respeitar a segurança: herdar as mesmas permissões e controles de governança de dados do usuário.
Pré-requisitos
Inscrição no Programa de prévia para desenvolvedores do Google Workspace.
Um projeto do Google Cloud. Para criar um projeto, consulte Criar um projeto.
Um cliente MCP, como o Google Antigravity.
Para executar os comandos nesta página, configure a gcloud CLI em um ambiente de desenvolvimento local seguindo estas etapas:
- Instale a CLI do Google Cloud.
Se você já instalou a CLI gcloud anteriormente, execute
gcloud components updatepara verificar se você tem a versão mais recente. - Se você usa um provedor de identidade (IdP) externo, faça login na CLI gcloud com sua identidade federada. Para mais informações, consulte Fazer login na CLI gcloud com sua identidade federada.
- Inicialize a CLI gcloud.
- Instale a CLI do Google Cloud.
Se você já instalou a CLI gcloud anteriormente, execute
Se estiver configurando o servidor MCP do Google Sala de Aula, uma turma de teste do Google Sala de Aula com pelo menos uma conta de estudante de teste. Se você não tiver uma turma do Google Sala de Aula para usar em testes, crie uma na interface e adicione um estudante de teste.
Configurar os servidores MCP do Google Workspace
Para usar os servidores MCP do Google Workspace, é necessário ativá-los no seu projeto na nuvem do Google Cloud e configurar o cliente MCP para se conectar a eles.
Ative as APIs
Para usar os servidores MCP do Google Workspace, ative as seguintes APIs no seu projeto do Google Cloud:
- API Gmail
- API Google Drive
- API Google Docs
- API Google Sheets
- API Google Slides
- API Google Calendar
- API Google Chat
- API People
Google Classroom API
CLI
gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.googleapis.com --project=PROJECT_ID
Substitua PROJECT_ID pelo ID do projeto do Google Cloud.
Console
Ative as APIs no console do Google Cloud:
Ativar os serviços do MCP
Para ativar os componentes do MCP para cada produto do Google Workspace, é necessário ativar os seguintes serviços no seu projeto do Google Cloud:
- API Gmail MCP
- API Google Drive MCP
- API MCP do Google Docs
- API MCP do Google Planilhas
- API MCP do Google Slides
- API MCP do Google Agenda
- API MCP do Google Chat
- API People MCP
API MCP do Google Sala de Aula
CLI
gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID
Substitua PROJECT_ID pelo ID do projeto do Google Cloud.
Console
Ative os serviços do MCP no console do Google Cloud:
Configurar o app do Chat
Para usar o servidor MCP do Google Chat, é necessário configurar um app do Chat no seu projeto do Google Cloud.
No console do Google Cloud, pesquise API Google Chat e clique em API Google Chat > Gerenciar > Configuração.
Configure o app do Chat:
- No campo Nome do app, digite
Chat MCP. - No campo URL do avatar, digite
https://developers.google.com/chat/images/quickstart-app-avatar.png. - Em Descrição, insira
Chat MCP server. - Em Funcionalidade, desative os recursos interativos desmarcando a opção Ativar recursos interativos.
- Em Registros, selecione Registrar erros no Logging.
- No campo Nome do app, digite
Clique em Salvar.
Para saber como criar um app do Chat, consulte Escolher uma arquitetura de app do Google Chat.
Configurar a tela de permissão OAuth
Os servidores MCP do Google Workspace usam o OAuth 2.0 para autenticação e autorização. É necessário configurar a tela de permissão OAuth antes de criar um ID do cliente OAuth.
No console do Google Cloud, acesse Plataforma de autenticação do Google > Branding.
Se você já configurou a Plataforma de autenticação do Google, é possível definir as seguintes configurações da tela de permissão OAuth em Branding, Público e Acesso a dados. Se aparecer a mensagem A plataforma de autenticação do Google ainda não está configurada, clique em Começar:
- Em Informações do app, em Nome do app, digite
Workspace MCP Servers. - Em E-mail para suporte do usuário, selecione seu endereço de e-mail ou um Grupo do Google apropriado.
- Clique em Próxima.
- Em Público-alvo, selecione Interno. Se não for possível selecionar Interno, escolha Externo.
- Clique em Próxima.
- Em Dados de contato, insira um endereço de e-mail para receber notificações sobre mudanças no projeto.
- Clique em Próxima.
- Em Concluir, leia a Política de dados do usuário dos serviços de API do Google e, se concordar, selecione Concordo com a Política de dados do usuário dos serviços de API do Google.
- Clique em Continuar.
- Clique em Criar.
- Se você selecionou Externo como tipo de usuário, adicione usuários de teste:
- Clique em Público-alvo.
- Em Usuários de teste, clique em Adicionar usuários.
- Insira seu endereço de e-mail e os outros usuários de teste autorizados. Depois, clique em Salvar.
- Em Informações do app, em Nome do app, digite
Clique em Acesso a dados > Adicionar ou remover escopos. Um painel vai aparecer com uma lista de escopos para cada API que você ativou no projeto na nuvem do Google Cloud.
Em Adicionar escopos manualmente, cole os escopos dos servidores MCP que você quer usar:
- Gmail:
https://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/gmail.compose
- Google Drive:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.file
- Google Docs:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/documents.readonlyhttps://www.googleapis.com/auth/documents
- Google Planilhas:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/spreadsheets.readonlyhttps://www.googleapis.com/auth/spreadsheets
- Google Slides:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/presentations.readonlyhttps://www.googleapis.com/auth/presentations
- Google Agenda:
https://www.googleapis.com/auth/calendar.calendarlist.readonlyhttps://www.googleapis.com/auth/calendar.events.freebusyhttps://www.googleapis.com/auth/calendar.events.readonly
- Google Chat:
https://www.googleapis.com/auth/chat.spaces.readonlyhttps://www.googleapis.com/auth/chat.memberships.readonlyhttps://www.googleapis.com/auth/chat.messages.readonlyhttps://www.googleapis.com/auth/chat.messages.createhttps://www.googleapis.com/auth/chat.users.readstate
- API People:
https://www.googleapis.com/auth/directory.readonlyhttps://www.googleapis.com/auth/userinfo.profilehttps://www.googleapis.com/auth/contacts.readonly
- Google Sala de Aula:
https://www.googleapis.com/auth/classroom.announcementshttps://www.googleapis.com/auth/classroom.courses.readonlyhttps://www.googleapis.com/auth/classroom.coursework.studentshttps://www.googleapis.com/auth/classroom.courseworkmaterialshttps://www.googleapis.com/auth/classroom.rosters.readonlyhttps://www.googleapis.com/auth/classroom.student-submissions.students.readonlyhttps://www.googleapis.com/auth/classroom.topics.readonly
- Gmail:
Clique em Adicionar à tabela.
Clique em Atualizar.
Depois de selecionar os escopos necessários para o app, na página Acesso a dados, clique em Salvar.
Configurar o cliente MCP
Para adicionar o servidor MCP remoto do Google Workspace ao seu cliente MCP, siga as instruções do cliente.
Antigravity
Para adicionar os servidores MCP remotos do Google Workspace ao Antigravity,
adicione a configuração do servidor ao arquivo mcp_config.json. Estas instruções são compatíveis com o Antigravity 2.0, o IDE do Antigravity e a CLI do Antigravity.
Crie um ID do cliente OAuth 2.0 e uma chave secreta:
No console do Google Cloud, acesse Plataforma de autenticação do Google > Clientes > Criar cliente
Selecione Aplicativo da Web como o tipo de aplicativo.
Digite um Nome.
Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e adicione
https://antigravity.google/oauth-callbackno campo URIs.Selecione Usar este cliente para um agente com tecnologia de IA.
Clique em Criar e copie o ID do cliente e a chave secreta do cliente.
Abra ou crie o arquivo de configuração
~/.gemini/config/mcp_config.json.Adicione a configuração
mcpServersamcp_config.json:{ "mcpServers": { "gmail": { "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "drive": { "serverUrl": "https://drivemcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "docs": { "serverUrl": "https://docsmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "sheets": { "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "slides": { "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "calendar": { "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "chat": { "serverUrl": "https://chatmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "people": { "serverUrl": "https://people.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "classroom": { "serverUrl": "https://classroommcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } } } }Substitua:
OAUTH_CLIENT_ID: o ID do cliente que você criou.OAUTH_CLIENT_SECRET: a chave secreta do cliente que você criou.
Economize
mcp_config.json.Autentique os servidores MCP. É possível autenticar usando as configurações da GUI ou da CLI:
Para o IDE do Antigravity ou a GUI (Antigravity 2.0):
- Abra a tela de configurações (por exemplo, clique em Configurações no canto inferior esquerdo ou abra Configurações do usuário do Antigravity).
- Acesse Personalizações.
- Em Servidores MCP instalados, clique em Atualizar.
- Para cada servidor listado (
gmail,drive,docs,sheets,slides,calendar,chat,peopleeclassroom), clique em Autenticar, faça login na sua Conta do Google, copie o código de autorização, cole-o na caixa de diálogo de entrada e clique em Enviar.
Para a CLI do Antigravity:
Inicie a CLI do Antigravity:
agyAbra o painel interativo de gerenciamento do MCP executando:
/mcpAutentique cada servidor MCP:
- Use as teclas de seta para selecionar o servidor, vá para a ação Autenticar e pressione Enter. Conclua o fluxo de login no navegador, copie o código de autorização, cole-o no prompt do terminal e pressione Enter.
- Repita essas etapas para cada servidor configurado (
gmail,drive,docs,sheets,slides,calendar,chat,peopleeclassroom).
Verifique se os servidores estão configurados corretamente e em execução:
- Para o IDE ou a GUI do Antigravity:um botão Sair é exibido ao lado de cada servidor em Personalizações > Servidores MCP instalados.
- Para a CLI do Antigravity:abra o painel
/mcppara conferir os servidores MCP configurados. Os servidores verificados e autenticados mostram Authed ao lado dos nomes no painel interativo da TUI. Selecione qualquer servidor na visualização do painel para inspecionar o status dele e listar todas as ferramentas disponíveis.
Os servidores MCP remotos estão prontos para uso no Antigravity.
Claude
Para usar os servidores MCP remotos do Google Workspace com o Claude.ai ou o Claude Desktop, você precisa ter o plano Claude Enterprise, Pro, Max ou Team.
Para adicionar os servidores MCP remotos do Google Workspace ao Claude, configure um conector personalizado com um ID e uma chave secreta do cliente OAuth.
Crie um ID do cliente OAuth 2.0 e uma chave secreta:
No console do Google Cloud, acesse Plataforma de autenticação do Google > Clientes > Criar cliente
Selecione Aplicativo da Web como o tipo de aplicativo.
Digite um Nome.
Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e adicione
https://claude.ai/api/mcp/auth_callbackno campo URIs.Selecione Usar este cliente para um agente com tecnologia de IA.
Clique em Criar e copie o ID do cliente e a chave secreta do cliente.
Configure o servidor MCP no Claude:
- No Claude.ai ou no Claude Desktop, acesse Configurações (ou Configurações de administrador) > Conectores.
- Clique em Adicionar conector personalizado.
Insira os detalhes de conexão do produto do Google Workspace que você quer adicionar:
- Nome do servidor: um nome para o servidor, como
Gmail. - URL do servidor MCP remoto: o URL do produto do Google Workspace, como um dos seguintes:
- Gmail:
https://gmailmcp.googleapis.com/mcp/v1 - Google Drive:
https://drivemcp.googleapis.com/mcp/v1 - Google Docs:
https://docsmcp.googleapis.com/mcp/v1 - Google Planilhas:
https://sheetsmcp.googleapis.com/mcp/v1 - Google Slides:
https://slidesmcp.googleapis.com/mcp/v1 - Google Agenda:
https://calendarmcp.googleapis.com/mcp/v1 - Google Chat:
https://chatmcp.googleapis.com/mcp/v1 - API People:
https://people.googleapis.com/mcp/v1 - Google Sala de Aula:
https://classroommcp.googleapis.com/mcp/v1
- Gmail:
- Nome do servidor: um nome para o servidor, como
Em Configurações avançadas, insira o ID do cliente OAuth e a chave secreta do cliente OAuth.
Clique em Adicionar.
Repita essas etapas para cada produto do Google Workspace que você quiser adicionar.
Outros
Muitos aplicativos de IA têm maneiras de se conectar a um servidor MCP remoto. Normalmente, é necessário inserir detalhes sobre o servidor, como nome, endpoints, protocolo de transporte e método de autenticação. Para os servidores MCP remotos do Google Workspace, digite o seguinte:
Nome do servidor:
googleworkspaceServidores: cada produto do Google Workspace tem o próprio URL de servidor:
- Gmail:
https://gmailmcp.googleapis.com/mcp/v1 - Google Drive:
https://drivemcp.googleapis.com/mcp/v1 - Google Docs:
https://docsmcp.googleapis.com/mcp/v1 - Google Planilhas:
https://sheetsmcp.googleapis.com/mcp/v1 - Google Slides:
https://slidesmcp.googleapis.com/mcp/v1 - Google Agenda:
https://calendarmcp.googleapis.com/mcp/v1 - Google Chat:
https://chatmcp.googleapis.com/mcp/v1 - API People:
https://people.googleapis.com/mcp/v1 - Google Sala de Aula:
https://classroommcp.googleapis.com/mcp/v1
- Gmail:
Transporte: HTTP com streaming
Autenticação: o servidor MCP remoto do Google Workspace usa o OAuth 2.0. Ao criar o cliente OAuth 2.0, selecione Usar este cliente para um agente com tecnologia de IA. Para mais detalhes, consulte Saiba mais sobre autenticação e autorização.
Seu cliente do MCP precisa de um token de atualização para evitar que os usuários tenham que fazer login novamente a cada hora. O servidor OAuth 2.0 do Google emite um token de atualização somente quando a solicitação de autorização inclui
access_type=offline. Solicitar apenas o escopooffline_accessdo OpenID Connect (OIDC) não retorna um. Se o cliente do MCP for compatível com parâmetros de autorização personalizados, adicioneaccess_type=offlineà solicitação de autorização. Para receber um novo token de atualização para um usuário que já concedeu acesso, adicione tambémprompt=consent. Se o cliente do MCP não for compatível com parâmetros de autorização personalizados, os usuários precisarão fazer login novamente sempre que o token de acesso expirar. Para mais detalhes, consulte Atualizar um token de acesso.
Para mais detalhes sobre como conectar diferentes tipos de clientes, consulte Configurar o MCP em um aplicativo de IA.
Testar os servidores MCP do Google Workspace
Depois de configurar o cliente MCP, verifique a conexão executando alguns comandos de teste.
Faça as seguintes perguntas ao seu cliente do MCP:
"O que a Ariel disse no último e-mail sobre nosso plano de marketing?"
O cliente filtra os e-mails de Ariel usando
gmail.search_threads, recupera o conteúdo da conversa mais recente comgmail.get_threade, em seguida, resume para você."Escreva um e-mail para ariel@example.com dizendo que aprovo o plano de marketing."
O cliente usa o
gmail.create_draftpara criar um e-mail na sua pasta de rascunhos, permitindo que você o revise e envie pelo Gmail."Resuma o arquivo Plano de Marketing."
O cliente chama
drive.search_filespara localizar "Plano de marketing" e usadrive.read_file_contentpara recuperar e resumir o conteúdo."Mostre o conteúdo estrutural das atas de reunião do Google Docs."
O cliente busca a estrutura e o conteúdo do documento usando
docs.read_doc."Leia a página Página1 do arquivo do Google Planilhas Vendas Trimestrais."
O cliente busca valores de grade usando
sheets.get_values."Mostre o layout verbalizado da apresentação do Google Slides 'Visão geral do produto'."
O cliente busca estruturas de layout visual de apresentação usando
slides.read_presentation."Quando é minha próxima reunião com a Ariel?"
O cliente verifica sua programação usando
calendar.list_eventse detalha sua próxima reunião com Ariel."De acordo com meu perfil do Google, qual é meu nome?"
O cliente usa
people.get_user_profilepara recuperar as informações do seu perfil do Google Workspace."Quais turmas estou ensinando atualmente?"
O cliente verifica sua programação usando
classroom.list_course_summariese resume os cursos ativos em que você tem a função de professor."Para minha aula de geologia, escreva um aviso sobre a próxima excursão."
O cliente usa o
classroom.create_announcementpara criar o rascunho do aviso, que você pode revisar e postar no app Google Sala de Aula.
Se as ferramentas forem executadas com sucesso e você receber respostas relevantes, seus servidores MCP do Google Workspace estão configurados corretamente.
Solução de problemas
Se você tiver problemas para se conectar aos servidores MCP, verifique se há erros nos registros do OAuth. Peça para o administrador verificar os eventos de registro do OAuth na ferramenta de investigação de segurança.
Se as solicitações para os servidores MCP forem rejeitadas, verifique se o cliente OAuth 2.0 tem a opção Usar este cliente para um agente com tecnologia de IA selecionada em Plataforma de autenticação do Google > Clientes. Se não for possível mudar essa configuração em um cliente OAuth atual, crie um novo cliente OAuth com a opção Usar este cliente para um agente com tecnologia de IA selecionada e atualize seu app para usá-lo. Se um cliente OAuth atual for usado para recursos de agente de IA e não agente, crie um cliente OAuth separado para o agente de IA e mantenha o cliente atual para os recursos não agente. Para instruções, consulte Configurar o cliente MCP e Gerenciar clientes OAuth.
Se o app usa uma conta de serviço com delegação em todo o domínio, não é possível selecionar Usar este cliente para um agente com tecnologia de IA, porque as contas de serviço não são gerenciadas em Plataforma de autenticação do Google > Clientes. As solicitações para os servidores MCP de contas de serviço que usam a delegação em todo o domínio não são rejeitadas por esse motivo. O acesso é controlado pelas configurações de delegação em todo o domínio gerenciadas pelo admin do Google Workspace. Para mais detalhes, consulte Controlar o acesso às APIs com a delegação em todo o domínio.
Se você chamar os servidores MCP do Google Apps Script, o Apps Script vai criar e gerenciar um cliente OAuth padrão para seu script, mas não será possível selecionar Usar este cliente para um agente com tecnologia de IA. Isso se aplica mesmo que o script use um projeto padrão do Google Cloud. Em vez disso, faça isto:
- No console do Google Cloud, acesse Plataforma de autenticação do Google > Clientes, crie um cliente OAuth e selecione Usar este cliente para um agente com tecnologia de IA.
- No script, use a biblioteca OAuth2 para Apps Script para autorizar usuários com esse cliente OAuth.
- Ao chamar os servidores MCP, envie o token de acesso retornado pela biblioteca,
em vez do token de
ScriptApp.getOAuthToken.
Os projetos do Apps Script que não chamam os servidores MCP não são afetados.
Se você precisar fazer login novamente a cada hora, seu cliente MCP não está
recebendo um token de atualização. O servidor OAuth 2.0 do Google emite um token de atualização apenas
quando a solicitação de autorização inclui access_type=offline. Solicitar apenas o escopo offline_access do OpenID Connect (OIDC) não retorna um. Se o cliente MCP
aceitar parâmetros de autorização personalizados, adicione access_type=offline à
solicitação de autorização. Para receber um novo token de atualização para um usuário que já
concedeu acesso, adicione também prompt=consent. Se o cliente do MCP não for compatível com
parâmetros de autorização personalizados, você precisará fazer login novamente sempre que o token de acesso
expirar. Para mais detalhes, consulte
Atualizar um token de acesso.
Produtos com suporte
Os seguintes produtos do Google Workspace são compatíveis com os servidores MCP do Google Workspace e oferecem as seguintes ferramentas:
- Gmail
- Google Drive
- Google Docs
- Google Planilhas
- Google Slides
- Google Agenda
- Google Chat
- API People
- Google Sala de Aula
create_announcementcreate_course_workcreate_course_work_rubriccreate_topicget_announcementsget_course_rosterget_course_workget_course_work_rubricget_coursesget_guardian_infolist_announcement_summarieslist_course_summarieslist_course_work_submissionslist_course_work_summarieslist_topicsupdate_course_work
Consideração importante sobre segurança: injeção indireta de comando
Quando você expõe um modelo de linguagem a dados não confiáveis, há o risco de um ataque de injeção de comando indireto. Como os clientes MCP, como o Google Antigravity, têm acesso a ferramentas e APIs avançadas pelos servidores MCP do Google Workspace, eles podem ler, modificar e excluir dados na sua Conta do Google.
Para reduzir esses riscos, siga estas práticas recomendadas:
- Use apenas ferramentas confiáveis. Nunca conecte servidores MCP do Google Workspace a aplicativos não confiáveis ou não verificados.
- Tenha cuidado com entradas não confiáveis. Evite pedir que o cliente do MCP processe e-mails, documentos ou outros recursos de fontes não verificadas. Essas entradas podem conter instruções ocultas que podem sequestrar sua sessão, permitindo que um invasor modifique, roube ou exclua seus dados.
- Revise todas as ações. Sempre revise com cuidado as ações realizadas pelo cliente de IA em seu nome para garantir que estejam corretas e alinhadas com suas intenções.