Gmail MCP

Gerenciar e resumir notas no Gmail usando a API do Gmail.

Documentação

Servidor MCP gmail-mcp

smithery badge um servidor mcp do gmail construído sobre typescript e a api do gmail

Este é um servidor MCP baseado em TypeScript que implementa um sistema simples de notas. Ele demonstra conceitos centrais do MCP ao fornecer:

  • Recursos que representam notas de texto com URIs e metadados
  • Ferramentas para criar novas notas
  • Prompts para gerar resumos de notas

Recursos

Recursos

  • Liste e acesse notas via URIs note://
  • Cada nota possui título, conteúdo e metadados
  • Tipo MIME de texto simples para acesso fácil ao conteúdo

Ferramentas

  • create_note - Criar novas notas de texto
    • Recebe título e conteúdo como parâmetros obrigatórios
    • Armazena a nota no estado do servidor

Prompts

  • summarize_notes - Gerar um resumo de todas as notas armazenadas
    • Inclui todo o conteúdo das notas como recursos incorporados
    • Retorna um prompt estruturado para sumarização por LLM

Desenvolvimento

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Instalação

Instalando via Smithery

Para instalar o Gmail Notes Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @mundume/gmail-mcp --client claude

Instalando Manualmente

Para usar com Claude Desktop, adicione a configuração do servidor:

No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "/path/to/gmail-mcp/build/index.js"
    }
  }
}

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector, que está disponível como um script do pacote:

npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.