systemprompt-mcp-gmail

MCP.Pizza Chef: Ejb503

systemprompt-mcp-gmail is a specialized MCP server that integrates Gmail with AI agents, enabling users to search, read, delete, and send emails seamlessly. Optimized for the Systemprompt MCP Voice client, it leverages AI to facilitate natural language interactions with Gmail, streamlining email management through automated, context-aware commands.

Use This MCP server To

Search Gmail inbox using natural language queries Read email contents aloud or display summaries Delete unwanted emails via voice or text commands Send new emails through AI-assisted composition Manage Gmail folders and labels with AI guidance Automate email triage and prioritization Integrate Gmail email actions into AI workflows Enable voice-controlled email management

README

systemprompt-mcp-gmail

npm version smithery badge License: Apache-2.0 Twitter Follow Discord

Website | Documentation | Blog | Get API Key

A specialized Model Context Protocol (MCP) server that enables you to search, read, delete and send emails from your Gmail account, leveraging an AI Agent to help with each operation. The server is designed to work with the multimodal-mcp-client, a voice-powered MCP client that provides the frontend interface.

An API KEY is required to use this server. This is currently free, although this may change in the future. You can get one here.

This server uses Sampling and Notification functionality from the @modelcontextprotocol/sdk.

This will only work with advanced MCP clients that support these features.

Required Client

This server is designed to work with the multimodal-mcp-client - a voice-powered MCP client that provides the frontend interface. Please make sure to set up both components for the full functionality.

Why Use This Server?

Send emails Search emails Read emails

Installation

This server requires GOOGLE_CREDENTIALS and GOOGLE_TOKEN environment variables to be set. These must be base64 encoded strings of the credentials and token. There is a script to help with this in the multimodal-mcp-client repository. Follow the instructions here: https://github.com/Ejb503/multimodal-mcp-client/blob/master/scripts/google-auth/README.md

After generating your base64 encoded strings, you can run the server with npx.

Features

Core Functionality

  • MCP Protocol Integration: Full implementation of Model Context Protocol for seamless AI agent interactions
  • Voice-Powered Interface: Compatible with voice commands through multimodal-mcp-client
  • Real-Time Processing: Supports streaming responses and real-time interactions
  • Type-Safe Implementation: Full TypeScript support with proper error handling

Sampling & Notifications

  • Advanced sampling capabilities for AI responses
  • Real-time notification system for agent events
  • Configurable sampling parameters
  • Event-driven architecture for notifications

Integration Features

  • API Key management and authentication
  • User status and billing information tracking
  • Subscription management
  • Usage monitoring and analytics

🎥 Demo & Showcase

Watch our video demonstration to see Systemprompt MCP Gmail in action:

▶️ Watch Demo Video

The demo showcases:

  • Voice-controlled AI interactions
  • Multimodal input processing
  • Tool execution and workflow automation
  • Real-time voice synthesis

Installation

Related Links

systemprompt-mcp-gmail FAQ

How do I authenticate systemprompt-mcp-gmail with my Gmail account?
You authenticate via OAuth 2.0, granting secure access to your Gmail data while maintaining privacy.
Can systemprompt-mcp-gmail handle attachments in emails?
Yes, it supports reading and sending emails with attachments through AI-assisted commands.
Is systemprompt-mcp-gmail compatible with other MCP clients besides Systemprompt Voice?
While optimized for Systemprompt Voice, it can integrate with other MCP clients supporting standard MCP protocols.
How does systemprompt-mcp-gmail ensure email data security?
It uses secure OAuth authentication and follows best practices for data encryption and access control.
Can I customize the AI agent’s behavior for email handling?
Yes, you can configure prompts and workflows to tailor AI responses and actions to your needs.
Does systemprompt-mcp-gmail support multiple Gmail accounts?
Yes, it can manage multiple accounts with separate authentication tokens.
What LLM providers work well with systemprompt-mcp-gmail?
It works with OpenAI, Anthropic Claude, and Google Gemini models for AI processing.
How do I get started with systemprompt-mcp-gmail?
Visit the official documentation at systemprompt.io/documentation for setup guides and API keys.