home / mcp / hiworks mail mcp server

Hiworks Mail MCP Server

Provides an MCP server that integrates Hiworks Mail to fetch and send messages via POP3/SMTP.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "beylessai-hiworks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hiworks-mail-mcp@latest"
      ],
      "env": {
        "HIWORKS_PASSWORD": "your_password",
        "HIWORKS_USERNAME": "[email protected]"
      }
    }
  }
}

You can run an MCP server that bridges Hiworks Mail with your MCP clients, enabling you to read and send emails through Hiworks using a standardized model. This makes it easy to automate mail workflows and integrate Hiworks Mail into your existing tooling.

How to use

Set up your MCP client to load the Hiworks Mail MCP configuration. You will provide your Hiworks credentials as environment variables so the MCP server can authenticate with the mail service. Once configured, your client can request mail data and actions from the Hiworks Mail MCP, such as fetching messages or sending new ones, allowing you to build automated mail flows and integrations.

How to install

Prerequisites you need before starting:

- Node.js installed (LTS version) and npm available on your system.

Follow these steps to prepare and use the Hiworks Mail MCP:

1) Ensure Node.js and npm are installed on your machine. You can verify with node -v and npm -v.

2) Create or update your MCP client configuration to include the Hiworks Mail MCP server. The configuration snippet you use should include the stdio MCP entry shown below. This loads the MCP package on demand via npx and provides the credentials needed to access Hiworks Mail.

{
  "mcpServers": {
    "hiworks_mail_mcp": {
      "command": "npx",
      "args": ["-y", "hiworks-mail-mcp@latest"],
      "env": {
        "HIWORKS_USERNAME": "[email protected]",
        "HIWORKS_PASSWORD": "your_password"
      }
    }
  }
}

Configuration and startup notes

- The MCP server uses the following mail endpoints by default: POP3 over SSL at pop3s.hiworks.com:995 and SMTP over SSL/TLS at smtps.hiworks.com:465. Keep these in mind if you need to adjust for your environment.

- Protect your credentials. Treat HIWORKS_USERNAME and HIWORKS_PASSWORD as sensitive data and restrict access to your configuration files and environment.

- When sending bulk mail, ensure you comply with Hiworks’ policies to avoid service restrictions.

Security and notes

- Store credentials securely and rotate passwords as needed. Use separate credentials for test and production environments whenever possible.

- Monitor and log MCP activity to detect unusual access or mass-mail attempts.

License

This project is released under the MIT license. See the LICENSE file for details.