MCP Server with Azure Communication Services Email

by lukemurraynz

2 stars
329 downloads
Not rated
GitHub

About

This is a Model Context Protocol (MCP) server that integrates Azure Communication Services email functionality, enabling programmatic email sending. It is intended for developers who need to send emails as part of MCP-based applications.

Details

Author
lukemurraynz
GitHub stars
2
Downloads
329
Categories
Cloud Service

- Send emails programmatically via MCP tools
- Uses Azure Communication Services email capabilities
- Requires a verified sender domain in ACS
- Simple configuration with environment variables
- Python 3.8+ runtime with minimal setup

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 MCP Server with Azure Communication Services Email
    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

Install dependencies with pip install -r requirements.txt, configure environment variables (ACS_CONNECTION_STRING and ACS_SENDER_ADDRESS) in a .env file, then run the server using python src/server.py. After starting, prompt the server to send an email.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "mcp server with azure communication services email": {
            "mcp-server-acsemail": {
                "command": "python",
                "args": [
                    "src/server.py"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-server-acsemail": {
        "command": "python",
        "args": [
            "src/server.py"
        ]
    }
}

MCP Server with Azure Communication Services Email

This is a Model Context Protocol (MCP) server with Azure Communication Services email functionality. It allows you to send emails programmatically and perform various operations.

Blog: Sending Emails with MCP and Azure Communication Services

Prerequisites

- Python 3.8 or higher
- Azure Communication Services resource with email capabilities configured
- Verified sender email address in Azure Communication Services

Setup

1. Install the required dependencies:

pip install -r requirements.txt

2. Configure your environment variables by creating a .env file in the root directory with the following variables:

ACS_CONNECTION_STRING=your_azure_communication_services_connection_string
ACS_SENDER_ADDRESS=your_verified_sender_address@your-domain.azurecomm.net

Azure Communication Services Setup

To use the email functionality, you need to:

1. Create an Azure Communication Services resource in the Azure Portal.
2. Configure Email Communication Services.
3. Verify a domain for sending emails.
4. Get your connection string from the Azure Portal.

Running the Server

Start the server by running the following command:

python src/server.py

Directory Structure

/workspaces/mcp-server-acsemail
├── README.md
├── requirements.txt
├── src/
│   └── server.py

- README.md: Documentation for the project.
- requirements.txt: Python dependencies.
- src/server.py: Main server script.

Features

The server provides the following tools and functionalities:

- Email Sending: Send emails using Azure Communication Services.

Example Usage

Here is an example of how to send an email using the server:

1. Start the server:

python src/server.py

2. Prompt to send email

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Commit your changes and push the branch.
4. Submit a pull request for review.

License

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

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.