Skip to main content

A resilient MCP server built with fastMCP for sending emails through Gmail's SMTP server using AI agents

Project description

Gmail-mcp-server

A resilient MCP server built with fastMCP for sending emails through Gmail's SMTP server using AI agents. smithery badge

Features

  • Send emails via Gmail SMTP
  • Fetch recent emails from Gmail folders
  • Handle email attachments
  • Health check endpoint for deployment monitoring

Deployment on Smithery.ai

This server is configured for deployment on Smithery.ai using Streamable HTTP transport.

Configuration

The server requires the following configuration parameters:

  • smtp_username: Your Gmail email address
  • smtp_password: Your Gmail app password (not your regular password)

Health Check

The server provides a health check endpoint at /health for Smithery deployment monitoring.

CLAUDE CONFIG EXAMPLE

{
  "mcpServers": {
    "terminal_server": {
      "command": "/Users/maitreyamishra/.local/bin/uv",
      "args": [
        "--directory", "Path to your mcp server file",
        "run",
        "terminal_server.py"
      ]
    },
    "web3_server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:3000/mcp"
      ]
    },
    "gmail_mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8989/mcp"
      ]
    }
  }
}

Port

The server runs on port 5000 and binds to all interfaces (0.0.0.0) for container deployment.

Local Development

  1. Install dependencies:

    pip install -r requirements.txt
    
  2. Set environment variables:

    export SMTP_USERNAME="your-email@gmail.com"
    export SMTP_PASSWORD="your-app-password"
    
  3. Run the server:

    python gmail_mcp.py
    

Docker

Build and run with Docker:

docker build -t gmail-mcp .
docker run -p 5000:5000 -e SMTP_USERNAME=your-email -e SMTP_PASSWORD=your-password gmail-mcp

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_maitreyam_gmail_mcp_server-1.0.0.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_maitreyam_gmail_mcp_server-1.0.0.tar.gz.

File metadata

  • Download URL: iflow_mcp_maitreyam_gmail_mcp_server-1.0.0.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_maitreyam_gmail_mcp_server-1.0.0.tar.gz
Algorithm Hash digest
SHA256 bda82bd59d2b5746e8769fc2a484950301c6ec1cff1dae45b9dda7778633d675
MD5 9982969d5f9b4687e5b06b786b580a0a
BLAKE2b-256 111d39285ab667efd8ebd557a3a721b6e3a4bf6b6f051e06dc54be1a0356391b

See more details on using hashes here.

File details

Details for the file iflow_mcp_maitreyam_gmail_mcp_server-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_maitreyam_gmail_mcp_server-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 5.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_maitreyam_gmail_mcp_server-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ce9c29a3f6b8011f026e1e40d3550997b3ca069b4d3db3b18f6c6071ade64d05
MD5 492e37063ce8fa41794392fba3c6fd9a
BLAKE2b-256 db5432382777efcbae0804b25a3944dafe62dcd82a72a48a3ad85216c2752fc1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page