mcpField
G
Gmail MCP Server

Gmail MCP Server

Local
github.com/christo707Communication0Updated 82w ago
Repository

About Gmail MCP Server

Gmail MCP Server is a Spring Boot server for Java developers who want to access Gmail operations through MCP. Its tools cover reading and sending messages, marking messages as read, and moving them to trash; a stdio client is included for testing.

Key features

  1. 01读取邮件和未读邮件
  2. 02发送邮件
  3. 03将邮件标记为已读
  4. 04将邮件移至垃圾箱
  5. 05提供 stdio 测试客户端

Use cases

  1. 01通过 MCP 查看未读邮件内容
  2. 02向指定收件人发送邮件
  3. 03处理邮件时标记已读或移至垃圾箱

MCP support

该 Spring Boot MCP 服务通过 GMailer 工具开放 Gmail 邮件操作。项目还包含使用标准输入输出与服务交互的 ClientStdio 测试客户端。

#gmail#mcp#java-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Gmail MCP Server

This project is a Spring Boot MCP (Model Context Protocol) server for Gmail. It provides various tools for interacting with Gmail through the GMailer class. Additionally, it includes a client, ClientStdio, to test the MCP server functionality.

Features

  • GMailer Tools:

    • trashEmail: Moves an email to the trash given its ID.
    • markEmailAsRead: Marks an email as read given its ID.
    • sendEmail: Sends an email to a specified recipient.
    • getUnreadMessages: Retrieves unread messages.
    • readEmail: Reads an email given its ID.

  • ClientStdio: A client to test the MCP server functionality using standard I/O.

Prerequisites

  • Java 17 or higher
  • Maven
  • Gmail API credentials

Setup

  1. Clone the repository:

    git clone <repository-url>
cd <repository-directory>

  2. Configure Gmail API credentials:

    • Create a new Google Cloud project
    • Enable the Gmail API
    • Configure an OAuth consent screen
      • Select "external". However, we will not publish the app.
      • Add your personal email address as a "Test user".
    • Add OAuth scope https://www.googleapis.com/auth/gmail/modify
    • Create an OAuth Client ID for application type "Desktop App"
    • Download the JSON file of your client's OAuth keys
    • Rename the key file to credentials.json and save it to your local machine in a secure location. Take note of the location.
    • Place your credentials.json file in the src/main/resources directory.

  3. Build the project:

    mvn clean install

Running the MCP Server

To start the MCP server, run the following command:

mvn spring-boot:run

Testing with ClientStdio

The ClientStdio class can be used to test the MCP server functionality. It interacts with the server using standard I/O.

Build the project first using the command:

mvn clean install -DskipTests

Then run the ClientStdio class.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.