Java Mcp Server For Smtp Mailing

by RayenMalouche

304 downloads
Not rated
GitHub

About

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.

Details

Author
RayenMalouche
Downloads
304
Categories
Developer Tools

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Java Mcp Server For Smtp Mailing
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "java mcp server for smtp mailing": {
            "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>"
                }
            }
        }
    }
}

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>"
        }
    }
}

Example: /home/username/Java-MCP-Server-For-SMTP-Mailing


Java Executable Path

Windows:
cmd where java
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.