[WIP] Programmable Email

@juecd

About [WIP] Programmable Email

MCP server for Gmail

#server #mcp #gmail #claude

Basic information

Category

Communication

Transports

stdio

Publisher

juecd

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "programmable-email": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "programmable-email"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Programmable Email?

Programmable Email is an MCP server that connects Claude (or any MCP client) with Gmail using local OAuth tokens. It is designed for experimentation and testing purposes, and any emails fetched will be sent to Claude’s servers.

How to use Programmable Email?

Obtain Gmail OAuth credentials (credentials.json and token.json), build the Docker image with docker build -t programmable-email ., then configure Claude Desktop’s claude_desktop_config.json to run the image. Open or restart Claude, then ask Claude to retrieve your recent unread emails.

Key features of Programmable Email

Connects Claude or any MCP client to Gmail
Uses local OAuth tokens for authentication
Runs inside a Docker container
Retrieves recent unread emails from Gmail
Designed for experimentation and testing
Fetched emails are sent to Claude’s servers

Use cases of Programmable Email

Retrieve and review recent unread emails via Claude
Experiment with MCP-based email tool integration
Test OAuth workflow for Gmail in a local MCP setup

FAQ from Programmable Email

What are the prerequisites?

Docker and Claude Desktop for Mac are required.

How do I get Gmail OAuth credentials?

Follow the Google Workspace guide to create a personal OAuth client ID for a server-side application. Place credentials.json in the root directory.

Where does `token.json` come from?

It is automatically generated the first time you use your Google OAuth credentials.

What are the current limitations?

Only a subset of Gmail search capabilities is available. Send functionality is not yet implemented. All fetched emails are sent to Claude’s servers.

Is Programmable Email production-ready?

No, it is intended for experimentation and testing only.

Comments

More Communication MCP servers

Teams Mcp

MCP server providing comprehensive Microsoft Teams and Graph API access for AI assistants including messaging, search, and user management.

mcp-email-server

IMAP and SMTP via MCP Server

Email sending MCP 💌

The official MCP server to send emails and interact with Resend

Mattermost MCP Server

Mattermost MCP server to enable Claude to interact with Mattermost Workspaces

Telegram MCP Server

Telegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.