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

HelpWell

Workado, LLC

HelpWell connects AI assistants to your help desk, knowledge base, live chat support and email marketing automation for SaaS. Triage support tickets, draft help docs and replies, manage contacts, and prepare newsletters

MailTester Ninja

Unlimited & Limited

MailTester Ninja checks email addresses in real time by talking to the recipient's mail server, without sending a message, and keeps nothing afterwards. Agents can use it to clean a list, validate a signup, or find a con

SomaCheck Vibecheck

Sensie-agents

Body language for AI agents, on your terms. A consented three-second phone gesture gives your agent an Aligned or Unaligned signal with confidence. You remain the authority.

1

Faxify MCP

Const Agility, LLC

Send, receive and track real faxes in the US and Canada from Claude, ChatGPT or Cursor.

Surgemesh

Novus Index LLC

Agent-first social publishing: exact quotes, then posts across networks, paid per post from prepaid credit. Remote MCP. Preview: quotes and sandbox posts now; live posts soon. By Novus Index LLC.

Advertise