Skip to main content
Glama
Sign In
enesjakozh

mcp-google

by Ejb503
Verified
npmGitHub
TypeScript
10
3
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables AI agents to read, send, manage drafts and attachments, search and filter emails, and handle email threads through MCP commands

  • Allows AI agents to create and manage events, handle event invitations, search and filter calendar events, and manage multiple calendars through MCP commands

  • Provides read-only access to Google Drive content through MCP, allowing AI agents to interact with files and documents

systemprompt-mcp-google

Sitio web | Documentación | Blog

Un servidor especializado de Protocolo de Contexto de Modelo (MCP) que integra los servicios de Google (Gmail, Calendario, etc.) en tus flujos de trabajo de IA. Este servidor permite un acceso fluido a los servicios de Google a través de MCP, lo que permite a los agentes de IA interactuar con Gmail, Calendario de Google y otros servicios de Google.

Manifestación

Demostración de YouTube

Prerrequisitos

Antes de utilizar este servidor, necesitarás:

  1. Una clave API de Systemprompt (gratuita):
  2. Un cliente compatible con MCP como:
  3. Configuración del proyecto de Google Cloud:
    • Una cuenta de Google Cloud
    • Acceso API habilitado para los servicios deseados (Gmail, Calendario, etc.)
    • Credenciales OAuth2 configuradas

Configuración

1. Configuración de Google Cloud

  1. Crear un proyecto en Google Cloud Console
  2. Habilite las API que necesita:
    • API de Gmail (leer, enviar, redactar, modificar, etiquetas)
    • API de Google Calendar (leer eventos)
    • API de Google Drive (solo lectura)
  3. Crear credenciales OAuth2:
    • Vaya a "API y servicios" > "Credenciales".
    • Crear un ID de cliente OAuth 2.0
    • Establecer URI de redireccionamiento autorizados (incluir http://localhost:3333/oauth2callback )
    • Descargue el archivo JSON de credenciales y guárdelo como credentials/google-credentials.json

2. Configuración del servidor

  1. Instalar el paquete:
npm install systemprompt-mcp-google
  1. Cree el directorio de credenciales:
mkdir -p credentials
  1. Ejecute el script de autenticación:
npm run auth-google

Esto hará lo siguiente:

  • Abra su navegador predeterminado para la autenticación de Google OAuth
  • Inicie un servidor local en el puerto 3333 para manejar la devolución de llamada OAuth
  • Generar y guardar tokens en credentials/google-token.json
  • Cerrar automáticamente una vez completada la autenticación

El script solicitará los siguientes permisos:

  • Gmail: leer, enviar, redactar, modificar y administrar etiquetas
  • Calendario: leer eventos y calendarios
  • Unidad: acceso de solo lectura

3. Configuración del cliente MCP

Elige tu cliente MCP preferido:

Uso del cliente MCP Systemprompt

  1. Instalar y configurar el cliente siguiendo sus instrucciones de configuración
  2. En la configuración MCP del cliente, agregue este servidor:
{ "servers": { "google": { "type": "stdio", "command": "SYSTEMPROMPT_API_KEY=your_api_key npx systemprompt-mcp-google" } } }

Nota: Reemplace your_api_key con su clave API de Systemprompt real desde systemprompt.io/console .

Uso de Claude Desktop

  1. Instalar Claude Desktop
  2. Agregue este servidor en la sección de configuración de MCP de Claude con la clave API:
    { "command": "SYSTEMPROMPT_API_KEY=your_api_key npx systemprompt-mcp-google" }
  3. Configurar la conexión para utilizar el modo stdio

Características

Integración de servicios de Google

  • Integración con Gmail
    • Leer y enviar correos electrónicos mediante comandos MCP
    • Administrar borradores y archivos adjuntos
    • Buscar y filtrar correos electrónicos
    • Gestionar hilos de correo electrónico
  • Integración de calendario
    • Crear y gestionar eventos mediante comandos MCP
    • Gestionar invitaciones a eventos
    • Buscar y filtrar eventos del calendario
    • Administrar múltiples calendarios

Integración MCP

  • Interfaz MCP estándar
    • Compatible con cualquier cliente compatible con MCP
    • Respuestas de comando estructuradas
    • Manejo de errores e informes de estado
    • Gestión de sesiones

Seguridad y autenticación

  • Flujo de autenticación segura de OAuth2
  • Actualización automática del token
  • Acceso limitado para diferentes servicios
  • Configuración basada en el entorno

Características de desarrollo

  • Compatibilidad total con TypeScript
  • Manejo integral de errores
  • Amplia cobertura de pruebas
  • Interfaz compatible con MCP

Configuración

  1. Configurar el proyecto Google Cloud y las credenciales de OAuth2:
    • Crear un proyecto en Google Cloud Console
    • Habilitar las API de Gmail y Calendario
    • Crear credenciales OAuth2
    • Descargar archivo de credenciales
  2. Configurar variables de entorno:
GOOGLE_CLIENT_ID=your_client_id GOOGLE_CLIENT_SECRET=your_client_secret GOOGLE_REDIRECT_URI=your_redirect_uri
  1. Ejecute el script de autenticación:
npm run auth-google

Uso

A través del cliente MCP

Una vez configurado, puede usar cualquier cliente MCP para enviar comandos a este servidor. Ejemplos de interacciones:

Operaciones de Gmail

// Example MCP command structure for sending an email { "command": "gmail.sendEmail", "parameters": { "to": "recipient@example.com", "subject": "Hello from MCP", "body": "This email was sent via MCP!" } } // Example MCP command for listing messages { "command": "gmail.listMessages", "parameters": { "maxResults": 10 } }

Operaciones del calendario

// Example MCP command for creating an event { "command": "calendar.createEvent", "parameters": { "summary": "Team Meeting", "start": "2024-03-01T10:00:00", "end": "2024-03-01T11:00:00", "attendees": ["team@company.com"] } } // Example MCP command for listing events { "command": "calendar.listEvents", "parameters": { "timeMin": "2024-03-01T00:00:00Z", "maxResults": 10 } }

Pruebas

El proyecto incluye pruebas integrales tanto para el manejo del protocolo MCP como para la integración del servicio de Google:

# Run all tests npm test # Watch mode for development npm run test:watch # Generate coverage report npm run test:coverage

Depuración de la comunicación MCP

Dado que los servidores MCP se comunican a través de stdio, la depuración requiere una consideración especial:

  1. Utilice el inspector MCP:
npm run inspector
  1. Habilitar el registro de depuración:
# Set environment variable DEBUG=mcp:* npm run dev
  1. Utilice el cliente de prueba proporcionado:
npm run test:client

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Proyectos relacionados

Desarrollo

Configuración de desarrollo local

  1. Clonar el repositorio:
git clone https://github.com/yourusername/systemprompt-mcp-google.git cd systemprompt-mcp-google
  1. Instalar dependencias:
npm install
  1. Configurar variables de entorno:
# Copy example environment file cp .env.example .env # Edit .env and add: SYSTEMPROMPT_API_KEY=your_api_key # Required - get from systemprompt.io/console
  1. Configurar las credenciales de Google:
  • Guarde sus credenciales de Google OAuth como credentials/google-credentials.json
  • Ejecute npm run auth-google para autenticarse con Google
  1. Iniciar servidor de desarrollo:
npm run dev

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

Un servidor especializado de Protocolo de Contexto de Modelo (MCP) que integra los servicios de Google (Gmail, Calendario, etc.) en tus flujos de trabajo de IA. Este servidor permite un acceso fluido a los servicios de Google a través de MCP, lo que permite a los agentes de IA interactuar con Gmail, Calendario de Google y otros servicios de Google.

  1. Demo
    1. Prerequisites
      1. Setup
        1. 1. Google Cloud Setup
        2. 2. Server Configuration
        3. 3. MCP Client Setup
      2. Features
        1. Google Service Integration
        2. MCP Integration
        3. Security & Authentication
        4. Development Features
        5. Configuration
      3. Usage
        1. Through MCP Client
        2. Testing
        3. Debugging MCP Communication
      4. License
        1. Related Projects
          1. Development
            1. Local Development Setup

          Related Resources

          Appeared in Searches

          ID: 0ixu86x2zs