Servidor MCP de Gmail

Un servidor de Protocolo de contexto de modelo (MCP) que integra Gmail con Claude Desktop, lo que permite a Claude acceder y comprender el contenido del correo electrónico mientras mantiene una gestión de contexto y controles de privacidad adecuados.

Características

Integración de la API de Gmail con la autenticación OAuth2
Gestión y almacenamiento seguros de tokens
Manejo de datos centrado en la privacidad
Gestión de ventanas de contexto para Claude
Registro completo y gestión de errores
Compatibilidad con Docker para una implementación sencilla

Prerrequisitos

Node.js >= 18.0.0
npm o hilo
Proyecto de Google Cloud con la API de Gmail habilitada
Clave API de Claude

Configuración

Clonar el repositorio:

git clone https://github.com/yourusername/gmail-mcp-server.git
cd gmail-mcp-server

Instalar dependencias:

npm install

Cree un archivo .env en el directorio raíz con las siguientes variables:

GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=http://localhost:3000/auth/google/callback
CLAUDE_API_KEY=your_claude_api_key
PORT=3000

Inicie el servidor de desarrollo:

npm run dev

Desarrollo

npm run dev : Inicia el servidor de desarrollo con recarga en caliente
npm test : Ejecutar pruebas
npm run lint : Ejecutar ESLint

Estructura del proyecto

gmail-mcp-server/
├── src/
│   ├── server.js          # Main server entry point
│   ├── auth.js            # Authentication handling
│   ├── gmail.js           # Gmail API integration
│   ├── claude.js          # Claude API integration
│   ├── logger.js          # Logging configuration
│   └── utils/             # Utility functions
├── tests/                 # Test files
├── .env                   # Environment variables
├── .gitignore            # Git ignore rules
├── package.json          # Project dependencies
└── README.md             # Project documentation

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Gmail MCP Server

Integrations