gmail-mcp-java-server

christo707/gmail-mcp-java-server

3.1
communication

If you are the rightful owner of gmail-mcp-java-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Gmail MCP Server is a Spring Boot server for interacting with Gmail using the Model Context Protocol.

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.

Related MCP Servers

View all communication servers →
elevenlabs-mcp

elevenlabs-mcp

4.6

by elevenlabs

Official ElevenLabs Model Context Protocol (MCP) server for interaction with Text to Speech and audio processing APIs.

ai_chatbot
mcp

mcp

4.4

by mondaycom

monday.com MCP is an open framework for integrating AI agents with monday.com, providing secure access to structured data and tools for smart decision-making.

cloud_platforms
sentry-mcp

sentry-mcp

4.4

by getsentry

Sentry-MCP is a prototype remote MCP server acting as middleware to the upstream Sentry API provider.

communication
discordmcp

discordmcp

4.4

by v-3

A Model Context Protocol (MCP) server that enables LLMs to interact with Discord channels, allowing them to send and read messages through Discord's API.

communication
mcp-compass

mcp-compass

4.3

by liuyoshio

MCP Compass is a discovery and recommendation service for exploring Model Context Protocol servers using natural language queries.

research_and_data
mcp-atlassian

mcp-atlassian

4.3

by sooperset

Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). This integration supports both Confluence & Jira Cloud and Server/Data Center deployments.

cloud_platforms
mcp-hotnews-server

mcp-hotnews-server

4.2

by wopal-cn

A Model Context Protocol (MCP) server that provides real-time hot trending topics from major Chinese social platforms and news sites.

entertainment_and_media
mcp-linkedin

mcp-linkedin

4.2

by adhikasp

A Model Context Protocol (MCP) server that provides tools to interact with LinkedIn's Feeds and Job API using an unofficial LinkedIn API.

communication
gistpad-mcp

gistpad-mcp

4.2

by lostintangent

GistPad MCP is a server for managing and sharing personal knowledge, daily notes, and reusable prompts via GitHub Gists, integrated with VS Code and GistPad.dev.

knowledge_and_memory
mcp-perplexity

mcp-perplexity

4.0

by daniel-lxs

The Perplexity MCP Server provides a Python-based interface to the Perplexity API, offering tools for querying responses, maintaining chat history, and managing conversations.

communication
interactive-mcp

interactive-mcp

4.0

by ttommyth

A MCP Server implemented in Node.js/TypeScript, facilitating interactive communication between LLMs and users.

communication
mcp-server-sample

mcp-server-sample

4.0

by gabrielfroes

Este projeto demonstra como construir um servidor MCP com integração a APIs externas e validação de dados.

communication
twilio_manager_mcp

twilio_manager_mcp

4.0

by errajibadr

Twilio Manager MCP is a Model Context Protocol implementation for managing Twilio resources, providing tools for managing Twilio subaccounts, phone numbers, and regulatory bundles through a standardized MCP interface.

communication
telegram-bot-mcp-server

telegram-bot-mcp-server

3.9

by siavashdelkhosh81

This project is a Telegram bot integration built using the Model Context Protocol (MCP) that exposes a suite of useful tools for interacting with the Telegram Bot API.

communication
tiktok-mcp

tiktok-mcp

3.9

by Seym0n

The TikTok MCP integrates TikTok access into Claude AI and other apps via TikNeuron.

ai_chatbot
twitter-mcp

twitter-mcp

3.7

by EnesCinr

This MCP server allows Clients to interact with Twitter, enabling posting tweets and searching Twitter.

communication
iMCP

iMCP

3.7

by mattt

iMCP is a macOS app designed to integrate AI with your digital life, utilizing the Model Context Protocol (MCP) to connect with various clients.

calendar_management
Inbox Zero AI

Inbox Zero AI

3.7

by elie222

Inbox Zero MCP Server is designed to help users manage their inbox efficiently by integrating with various desktop applications.

communication
laravel-mcp-sdk

laravel-mcp-sdk

3.7

by mohamedahmed01

A Laravel package for implementing the Model Context Protocol (MCP) in Laravel applications, facilitating communication between AI models and Laravel applications through standardized interfaces.

communication
gitlab-mcp

gitlab-mcp

3.7

by zereight

GitLab MCP Server with enhancements and bug fixes over the original version.

developer_tools
mcp-deepseek-demo

mcp-deepseek-demo

3.7

by Ulanxx

MCP DeepSeek 演示项目是一个基于 Model Context Protocol (MCP) 的客户端应用，用于与 DeepSeek AI 模型进行交互。

communication
linkedin-mcp-server

linkedin-mcp-server

3.7

by stickerdaniel

A Model Context Protocol (MCP) server that enables interaction with LinkedIn through Claude and other AI assistants, allowing for profile scraping, company analysis, and job searches.

communication
spotify-mcp

spotify-mcp

3.7

by varunneal

MCP project to connect Claude with Spotify using spotipy-dev's API.

entertainment_and_media
homeassistant-mcp

homeassistant-mcp

3.7

by tevonsb

The server uses the MCP protocol to share access to a local Home Assistant instance with an LLM application.

os_automation
telegram-mcp

telegram-mcp

3.7

by chigwell

Telegram MCP Server is a full-featured integration for Telegram, allowing programmatic interaction with Telegram accounts using the Model Context Protocol (MCP).

communication
lark-openapi-mcp

lark-openapi-mcp

3.6

by larksuite

Feishu/Lark OpenAPI MCP is a tool designed to facilitate integration with the Feishu/Lark platform, enabling AI agents to perform tasks like document processing, conversation management, and calendar scheduling.

communication
mcp-send-email

mcp-send-email

3.6

by resend

This is a simple MCP server that sends emails using Resend's API, allowing integration with tools like Cursor or Claude Desktop for seamless email composition and sending.

communication