Programmable Email logo

Programmable Email

by juecd

Programmable Email is an MCP server designed to connect Claude with Gmail using Gmail's local oauth tokens. It's built for experimentation and testing, allowing Claude to interact with your Gmail account.

View on GitHub

Last updated: N/A

What is Programmable Email?

Programmable Email is an MCP server that bridges the gap between Claude (or any MCP client) and Gmail. It allows Claude to access and potentially manipulate your Gmail account using Gmail's OAuth tokens.

How to use Programmable Email?

  1. Generate Gmail OAuth credentials (credentials.json and token.json).
  2. Build the Docker image using docker build -t programmable-email ..
  3. Configure Claude by editing claude_desktop_config.json to include the Programmable Email server definition.
  4. Open or restart Claude.
  5. Ask Claude to retrieve your recent unread emails.

Key features of Programmable Email

  • Connects Claude with Gmail

  • Uses Gmail's OAuth tokens for authentication

  • Dockerized for easy deployment

  • MCP server implementation

  • Supports Gmail read functionality (partial)

  • Potential for Gmail send functionality

Use cases of Programmable Email

  • Automating email retrieval with Claude

  • Experimenting with Claude's ability to process email content

  • Building custom email workflows with Claude

  • Testing MCP server integrations with Claude

  • Analyzing email data using Claude's capabilities

FAQ from Programmable Email

Is this production-ready?

No, this server is designed for experimentation and testing purposes.

What security considerations should I be aware of?

Note that any emails fetched will be sent to Claude's servers. Ensure you understand the privacy implications before using this server with sensitive data.

What Gmail functionalities are currently supported?

Currently, only a subset of available search capabilities for Gmail read functionality are available.

Will Gmail send functionality be implemented?

Yes, Gmail send functionality is planned as an MCP tool.

What are the prerequisites for using this server?

You need Docker and Claude Desktop for Mac installed.