Skip to main content
Glama
enesjakozh

Gmail MCP Server

by jmonsellier
GitHub
Python
GPL 3.0
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Servidor de Gmail para el Protocolo de Contexto de Modelo (MCP)

Este servidor MCP se integra con Gmail para permitir enviar, eliminar, leer, redactar y responder correos electrónicos.

Nota: Este servidor permite que un cliente MCP lea, elimine y envíe correos electrónicos. Sin embargo, el cliente avisa al usuario antes de realizar dichas actividades.

https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90

Componentes

Herramientas

  • enviar correo electrónico
    • Envía un correo electrónico al destinatario de la dirección de correo electrónico
    • Aporte:
      • recipient_id (cadena): Dirección de correo electrónico del destinatario
      • subject (cadena): asunto del correo electrónico
      • message (cadena): contenido del correo electrónico
    • Devuelve el estado y el message_id
  • correo electrónico basura
    • Mueve el correo electrónico a la papelera
    • Aporte:
      • email_id (cadena): ID de correo electrónico generado automáticamente
    • Devuelve un mensaje de éxito
  • marcar correo electrónico como leído
    • Marca el correo electrónico como leído
    • Aporte:
      • email_id (cadena): ID de correo electrónico generado automáticamente
    • Devuelve un mensaje de éxito
  • obtener correos electrónicos no leídos
    • Recupera correos electrónicos no leídos
    • Devuelve una lista de correos electrónicos, incluido el ID del correo electrónico.
  • leer correo electrónico
    • Recupera el contenido del correo electrónico proporcionado
    • Aporte:
      • email_id (cadena): ID de correo electrónico generado automáticamente
    • Devuelve el diccionario de metadatos de correo electrónico y marca el correo electrónico como leído
  • correo electrónico abierto
    • Abrir el correo electrónico en el navegador
    • Aporte:
      • email_id (cadena): ID de correo electrónico generado automáticamente
    • Devuelve un mensaje de éxito y abre el correo electrónico indicado en el navegador predeterminado.

Configuración

Configuración de la API de Gmail

  1. Crear un nuevo proyecto de Google Cloud
  2. Habilitar la API de Gmail
  3. Configurar una pantalla de consentimiento de OAuth
    • Seleccione "externo". Sin embargo, no publicaremos la aplicación.
    • Añade tu dirección de correo electrónico personal como "Usuario de prueba".
  4. Agregar ámbito OAuth https://www.googleapis.com/auth/gmail/modify
  5. Cree un ID de cliente OAuth para el tipo de aplicación "Aplicación de escritorio"
  6. Descargue el archivo JSON de las claves OAuth de su cliente
  7. Cambie el nombre del archivo de clave y guárdelo en una ubicación segura de su equipo local. Anote la ubicación.
    • La ruta absoluta a este archivo se pasará como parámetro --creds-file-path cuando se inicie el servidor.

Autenticación

Al iniciar el servidor, se iniciará un flujo de autenticación en el navegador del sistema. Las credenciales del token se guardarán (y se recuperarán posteriormente) en la ruta absoluta del archivo indicada en el parámetro --token-path .

Por ejemplo, puede utilizar un directorio de puntos en su carpeta de inicio, reemplazando [your-home-folder] .:

ParámetroEjemplo
--creds-file-path/[your-home-folder]/.google/client_creds.json
--token-path/[your-home-folder]/.google/app_tokens.json

Uso con la aplicación de escritorio

Se recomienda el uso de rayos UV .

Para integrar este servidor con Claude Desktop como cliente MCP, agregue lo siguiente a la configuración del servidor de su aplicación. De forma predeterminada, se almacena como ~/Library/Application\ Support/Claude/claude_desktop_config.json .

{ "mcpServers": { "gdrive": { "command": "uv", "args": [ "--directory", "[absolute-path-to-git-repo]", "run", "gmail", "--creds-file-path", "[absolute-path-to-credentials-file]", "--token-path", "[absolute-path-to-access-tokens-file]" ] } } }

Se deben configurar los siguientes parámetros

ParámetroEjemplo
--directoryRuta absoluta al directorio gmail que contiene el servidor
--creds-file-pathRuta absoluta al archivo de credenciales creado en la configuración de la API de Gmail.
--token-pathRuta absoluta para almacenar y recuperar tokens de acceso y actualización para la aplicación.

Solución de problemas con MCP Inspector

Para probar el servidor, use MCP Inspector . Desde el repositorio de Git, ejecute lo siguiente y modifique los argumentos de los parámetros según corresponda.

npx @modelcontextprotocol/inspector uv run [absolute-path-to-git-repo]/src/gmail/server.py --creds-file-path [absolute-path-to-credentials-file] --token-path [absolute-path-to-access-tokens-file]

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

local-only server

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

Se integra con Gmail para permitir el envío, la lectura, la redacción y la gestión de correos electrónicos a través del Protocolo de contexto de modelo (MCP), lo que permite a los usuarios interactuar con tareas de correo electrónico a través de indicaciones automatizadas del cliente.

  1. Componentes
    1. Herramientas
  2. Configuración
    1. Configuración de la API de Gmail
    2. Autenticación
    3. Uso con la aplicación de escritorio
    4. Solución de problemas con MCP Inspector

Related Resources

Related MCP Servers

  • mcp-google

    Ejb503
    -
    security
    F
    license
    -
    quality
    A specialized Model Context Protocol (MCP) server that integrates Google services (Gmail, Calendar, etc.) into your AI workflows. This server enables seamless access to Google services through MCP, allowing AI agents to interact with Gmail, Google Calendar, and other Google services.
    Last updated -
    10
    3
    TypeScript

  • Email Sending MCP

    resend
    A
    security
    F
    license
    A
    quality
    A simple MCP server that enables users to send emails using Resend's API, integrating with tools like Cursor and Claude Desktop for seamless email composition and delivery.
    Last updated -
    1
    6
    321
    TypeScript
    • Apple

  • Gmail MCP Server

    jasonsum
    -
    security
    A
    license
    -
    quality
    MCP server that integrates with Gmail to enable sending, reading, and managing emails through tools like send-email, trash-email, get-unread-emails, and read-email.
    Last updated -
    17
    Python
    GPL 3.0
    • Apple

  • Mail MCP Tool

    shuakami
    A
    security
    F
    license
    A
    quality
    An MCP-based email tool that enables AI models to access email services through standardized interfaces, allowing AI assistants to perform various email operations like sending emails, reading inboxes, and handling attachments.
    Last updated -
    17
    16
    TypeScript
    • Apple
    • Linux

View all related MCP servers

Appeared in Searches

New MCP Servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jmonsellier/gmail-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server