Java Mcp Server For Smtp Mailing

Name: Java Mcp Server For Smtp Mailing
Author: RayenMalouche

@RayenMalouche

About Java Mcp Server For Smtp Mailing

A Model Context Protocol (MCP) server (using java sdk 0.11.0) that provides email sending capabilities through SMTP integration. This server acts as a bridge between MCP-compatible AI assistants (like Claude Desktop) and email services.

#smtp #mailing #java

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "smtp-email-server": {
      "command": "<JAVA_EXECUTABLE_PATH>",
      "args": [
        "-jar",
        "<FULL_PATH_TO_PROJECT>\\target\\RayenMalouche-0.0.1-SNAPSHOT.jar",
        "--stdio"
      ],
      "env": {
        "JAVA_HOME": "<JAVA_HOME_PATH>"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Java Mcp Server For Smtp Mailing?

An MCP server that provides email sending capabilities via SMTP integration, supporting STDIO, SSE, and Streamable HTTP transports. It exposes a send-email tool and REST endpoints, designed for integrating email into AI applications, automation workflows, and testing environments.

How to use Java Mcp Server For Smtp Mailing?

Clone the repository, configure SMTP credentials (e.g., Gmail app password) in Application.java, build with mvn clean package, then run with --stdio, --sse, or --streamable-http flags. For Claude Desktop, add the server configuration to the client’s config.json. Test via MCP Inspector, REST API (POST /api/test-email, GET /api/health), or direct MCP client calls.

Key features of Java Mcp Server For Smtp Mailing

Multiple transport protocols: STDIO, SSE, and Streamable HTTP
MCP tool send-email with parameters to, subject, body, cc, bcc
REST API endpoints for email sending and health checks
Pre-configured Gmail SMTP with TLS support
Support for alternative SMTP providers (Outlook, Yahoo, custom)
Built-in retry mechanism and rate limiting

Use cases of Java Mcp Server For Smtp Mailing

Sending emails directly from AI assistants like Claude Desktop
Automated email notifications in MCP‑based workflows
Testing email integrations via REST endpoints or MCP Inspector
Sending batch emails with CC/BCC support from scripts or applications
Integrating email capabilities into custom MCP clients and toolchains

FAQ from Java Mcp Server For Smtp Mailing

What prerequisites are needed to run the server?

Java 21 or higher, Maven 3.6+, a Gmail account with an app‑specific password (or other SMTP credentials), and an MCP client for testing (e.g., Claude Desktop or MCP Inspector).

How do I obtain a Gmail app password?

Enable 2‑factor authentication on your Gmail account, go to Google Account settings > Security > App passwords, generate a new password, and use it as the SMTP_PASSWORD value in the configuration.

Can I use a different SMTP provider besides Gmail?

Yes. Change the SMTP_HOST, SMTP_PORT, and TLS/SSL flags in Application.java. The README includes examples for Microsoft Outlook, Yahoo Mail, and custom SMTP servers.

What transport protocols are supported?

STDIO (for Claude Desktop and direct integration), Server‑Sent Events (SSE, for web applications), and Streamable HTTP (for testing and REST clients).

How can I test the server without an MCP client?

Use the REST endpoints. Start the server with --streamable-http, then send a POST request to http://localhost:45450/api/test-email with a JSON body containing to, subject, and body. A health check is available at GET /api/health.