1. Acessar o Google Cloud Console pelo navegador;
2. Criar novo projeto com nome descritivo (ex.: "gcalendar agent");
3. Alternar para o novo projeto após a conclusão da inicialização.

0. Se solicitado, clicar em "Configurar tela de consentimento";
1. Informar o nome do aplicativo (ex.: "calendar mcp");
2. Especificar o endereço de e-mail autorizado;
3. Selecionar "Público externo" para restrições de tipo de usuário;
4. Fornecer informações de contato utilizando o mesmo e-mail;
5. Aceitar os requisitos da Política de Dados do Usuário.

1. Navegar até APIs e Serviços → Biblioteca;
2. Pesquisar por "Calendar API";
3. Selecionar o primeiro resultado e habilitar o acesso à API;
4. Verificar se o status da API está como "Habilitada".

1. Acessar a seção Credenciais em APIs e Serviços;
2. Criar ID do cliente OAuth;
3. Selecionar "Aplicativo para computador" como tipo de aplicativo;
4. Baixar o arquivo JSON de credenciais gerado;
5. Armazenar temporariamente o arquivo na área de trabalho para fácil acesso (opcional).

No Claude, copie e cole o seguinte prompt:

Create a new folder named projects in my Documents directory to store all MCP servers.
Then clone the repository using: git clone https://github.com/nspady/google-calendar-mcp.git into that folder.
After cloning, move the file gcp-oauth.keys.json from my Desktop into the cloned repo.

Claude criará automaticamente a pasta projects, clonará o repositório e moverá o arquivo de credenciais JSON para dentro do repositório.

• Abra sua pasta Documents;
• Verifique se há uma nova pasta projects;
• Dentro do repositório clonado, localize a nova pasta (por exemplo, google-calendar-mcp). O arquivo gcp-oauth.keys.json deve estar dentro do repositório.

Execute o próximo prompt no Claude:

add next config block to claude config file
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }

• Abra Configurações → atalho: Cmd + , no Mac ou Ctrl + , no Windows;
• Vá até a aba Developer → clique em Edit Config;
• Abra o arquivo claude_desktop_config.json com um editor de texto. O arquivo JSON deve exibir agora o novo bloco de configuração com o caminho correto para seu arquivo de credenciais;
• Se estiver correto, feche a janela de configuração.

• Saia completamente do Claude (Mac: Cmd + Q, Windows: Alt + F4);
• Reinicie o aplicativo;
• Ao iniciar, você será redirecionado para uma página de autenticação do Google:
  • Selecione a mesma conta Google utilizada no projeto;
  • Quando solicitado, clique em Permitir para conceder acesso;
  • Após ver a mensagem de autenticação bem-sucedida, feche a aba.

No Terminal (Mac) ou Prompt de Comando (Windows), inicie pelo diretório raiz (por padrão) e navegue até a pasta onde serão armazenados todos os diretórios de Agentes de IA futuros.

• Para acessar uma pasta, utilize o comando cd folder_name, por exemplo:

cd Documents

Para criar uma nova pasta, utilize o comando mkdir new_folder_name, por exemplo:

mkdir projects

E navegue até essa nova pasta com o comando cd command:

cd projects

Utilize o comando git clone link para clonar o repositório do GitHub:

git clone https://github.com/nspady/google-calendar-mcp.git

Acesse o repositório recém-criado utilizando o comando cd:

cd google-calendar-mcp

Agora é necessário mover o arquivo de credenciais para a pasta do agente de IA (google_calendar_mcp). Isso pode ser feito manualmente, arrastando o ícone do arquivo para a pasta aberta no explorador de arquivos. Ou utilize o Terminal/Linha de Comando e copie o arquivo com o comando cp path/to/file_name ., por exemplo:

cp ~/Desktop/gsp-oauth.keys.json .

O ponto (.) ao final indica o diretório atual como destino.

É possível verificar se o arquivo JSON foi movido com sucesso para a pasta usando o comando ls no Terminal e localizando o nome do arquivo na lista.

Após mover o arquivo, exclua-o do local original (por exemplo, Desktop).

No Terminal/Linha de Comando utilize

npm install

Este comando baixa todos os pacotes e dependências necessários.

Continue no Terminal/Linha de Comando e execute

npm start

Este comando executa o script de inicialização padrão definido no arquivo package.json do projeto, que normalmente inicia a aplicação ou servidor; neste caso, inicia o fluxo de autenticação.

1. Janela do navegador é aberta automaticamente;
2. Seleção da conta Google apropriada;
3. Concessão de permissões de acesso ao calendário;
4. Confirmação da mensagem "Autenticação bem-sucedida";
5. Fechamento da janela do navegador.

Integração com Claude Desktop

• Copie o bloco de configuração:

    "google-calendar": {
      "command": "node",
      "args": [
        "/path/to/build/index.js"
      ]
    }

• Acesse o arquivo de configuração do Claude via Command/Ctrl + , → "Developer" → "Edit Config";
• Abra o arquivo de configuração claude_desktop_config.json com um editor de texto;
• Adicione a nova configuração como próximo bloco após as configurações existentes e antes das duas últimas chaves de fechamento;
• Certifique-se da sintaxe correta do JSON, com fechamento adequado das chaves e vírgulas após cada bloco de configuração, exceto o último.

No Terminal/Linha de Comando execute

pwd

Copie o caminho completo do diretório e insira antes de "/build" no arquivo de configuração.

Salve o arquivo de configuração com Command/Ctrl + S.

1. Reinicie completamente o Claude Desktop;
2. Verifique se o novo servidor aparece nas ferramentas disponíveis.