[WIP] Programmable Email

@juecd

About [WIP] Programmable Email

MCP server for Gmail

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.

Frequently asked questions

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

Basic information

More Communication MCP servers

Modular Outlook MCP Server

ryaker

MCP server for Claude to access Outlook data via Microsoft Graph API

398

SocialRobot

socialrobot-io

Schedule and analyze social media posts from Claude, ChatGPT, Cursor, or Gemini. SocialRobot's remote MCP server connects Instagram, LinkedIn, X, TikTok, Facebook, Threads, Pinterest, Bluesky, and Mastodon, then creates,