Advertise
MCP.so
Sign In

Gmail MCP Server

@christo707

Repository

Basic information

Category

Communication

License

MIT

Transports

stdio

Author

christo707

About Gmail MCP Server

Gmail MCP Server using Java and Spring Boot

#gmail#mcp#java-server

Gmail MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Gmail 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 Gmail MCP Server?

Gmail MCP Server is a Spring Boot MCP (Model Context Protocol) server that provides tools for interacting with Gmail, such as sending, reading, trashing, and marking emails. It also includes a client (ClientStdio) for testing the server via standard I/O.

How to use Gmail MCP Server?

Requires Java 17+, Maven, and Gmail API credentials. Clone the repository, configure OAuth credentials (place credentials.json in src/main/resources), build with mvn clean install, then run the server with mvn spring-boot:run. The ClientStdio client can be used for testing.

Key features of Gmail MCP Server

  • trashEmail: Moves an email to the trash by ID.
  • markEmailAsRead: Marks an email as read by ID.
  • sendEmail: Sends an email to a specified recipient.
  • getUnreadMessages: Retrieves unread messages.
  • readEmail: Reads an email by its ID.
  • ClientStdio: test client using standard I/O.

Use cases of Gmail MCP Server

  • Automate email management tasks through MCP-powered assistants.
  • Send notifications or replies programmatically.
  • Read and organize inbox without manual Gmail access.
  • Integrate Gmail actions into MCP-based workflows.

Frequently asked questions

1

What are the prerequisites?

Java 17 or higher, Maven, and Gmail API credentials.

2

How do I get Gmail API credentials?

Create a Google Cloud project, enable the Gmail API, configure an OAuth consent screen (external, with your email as a test user), and create an OAuth Client ID for a Desktop App. Download the JSON, rename it to `credentials.json`, and place it in `src/main/resources`.

3

How do I run the server?

After building the project with `mvn clean install`, run `mvn spring-boot:run`.

4

Is there a test client included?

Yes, the `ClientStdio` class can be used to test the MCP server functionality using standard I/O.

5

What OAuth scope is required?

The scope `https://www.googleapis.com/auth/gmail/modify` is used.

Comments

More Communication MCP servers

Pidgeon

Pidgeon

Email inboxes for AI agents. Give an agent its own address in one call; it sends, receives and replies in threads, waits for a sign-up code and gets it back already extracted, and hands a conversation to a person when it

Socialync

Jack Vitick

Draft, schedule, and publish social media posts to 8 platforms from any AI agent: Facebook, Instagram, X, TikTok, YouTube, LinkedIn, Threads, and Bluesky. 19 tools covering drafting, scheduling, publishing, media upload,

Atomic Mail Agentic

Atomic-Mail

Let your agents read, send and react to email autonomously, without human involvement

255

SendRaven

CommonNinja

SendRaven is email infrastructure for AI agents. Send, read replies as threads, run campaigns and automations, with limits on the API key.

1

B2B Creators

Social Tree Global

Agencies and GTM teams use HeyReach and Instantly to run LinkedIn outbound from personal sender profiles — but those profiles sit empty and prospects don't accept. B2B Creators is the content layer that keeps every sende

Advertise