Gmail MCP

Servidor MCP gmail-mcp

un servidor mcp de gmail construido sobre typescript y la api de gmail

Este es un servidor MCP basado en TypeScript que implementa un sistema simple de notas. Demuestra conceptos centrales de MCP al proporcionar:

• Recursos que representan notas de texto con URIs y metadatos
• Herramientas para crear nuevas notas
• Prompts para generar resúmenes de notas

Características

Recursos

• Lista y accede a notas mediante URIs note://
• Cada nota tiene un título, contenido y metadatos
• Tipo mime de texto plano para acceso simple al contenido

Herramientas

• create_note - Crear nuevas notas de texto
  • Toma título y contenido como parámetros requeridos
  • Almacena la nota en el estado del servidor

Prompts

• summarize_notes - Generar un resumen de todas las notas almacenadas
  • Incluye todo el contenido de las notas como recursos incrustados
  • Devuelve un prompt estructurado para el resumen por LLM

Desarrollo

Instala las dependencias:

npm install

Compila el servidor:

npm run build

Para desarrollo con recompilación automática:

npm run watch

Instalación

Instalación mediante Smithery

Para instalar Gmail Notes Server para Claude Desktop automáticamente a través de Smithery:

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

Instalación manual

Para usarlo con Claude Desktop, agrega la configuración del servidor:

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

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

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser un desafío. Recomendamos usar el Inspector MCP, que está disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.