Advertise
MCP.so
Sign In

[WIP] Programmable Email MCP Server

@juecd

Repository

Basic information

Category

Communication

Transports

stdio

Author

juecd

About [WIP] Programmable Email MCP Server

MCP server for Gmail

#server#mcp#gmail#claude

[WIP] Programmable Email MCP Server config

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

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

[WIP] Programmable Email MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

What are the prerequisites?

Docker and Claude Desktop for Mac are required.

2

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.

3

Where does `token.json` come from?

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

4

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.

5

Is Programmable Email production-ready?

No, it is intended for experimentation and testing only.

Comments

More Communication MCP servers

Vocenya

GH Business Solutions

Connect an AI assistant to one Vocenya business account: list calls, leads, bookings and chats, add leads, queue compliant AI callbacks and update Do Not Call.https://github.com/gadyamedia/vocenya-mcp

Mobile Text Alerts SMS

Mobile Text Alerts

Official Mobile Text Alerts server. Send and schedule SMS, manage subscribers and groups, and complete carrier registration from any MCP-compatible AI assistant.

eSIMfly MCP

eSimfly-Official

MCP server for the eSIMfly Business API — let Claude, Cursor and other AI agents search eSIM plans, check usage, diagnose connectivity and (optionally) order

Agent Inbox

Agent Inbox

Give your agent an inbox. Its own address on email, Slack and Telegram. A product of Novu

Mektup-mcp

WeeCi

Mektup gives AI agents and their humans a real email mailbox, not just a one-way sending API. Through 41 MCP tools, an agent can register a domain, create a mailbox, send and receive mail, and manage threads, drafts, fol

Advertise