sidemail

The Sidemail MCP Server exposes a set of MCP commands that allow programmatic management of Sidemail resources such as domains, contacts, Messenger drafts, and sent emails. Run the MCP client against the sidemail-mcp server (via VS Code MCP integration, the CLI, or other MCP clients) to perform operations like listing domains, creating or updating Messenger drafts, or querying contacts and emails. Tools are organized by resource type, each providing a concise set of actions you can invoke from your MCP client. To authenticate, supply your Sidemail API key through the SIDEMAIL_API_KEY environment variable when configuring the server. Once configured, you can begin issuing MCP commands such as list-domains, create-domain, list-messenger-drafts, and more to manage your Sidemail account from your development environment.

Prerequisites:

• Node.js v18 or newer installed on your machine
• Sidemail API Key

Installation steps:

1. Ensure Node.js is installed. Verify with: node -v npm -v
2. Install or use a tooling environment that can run MCP servers (e.g., VS Code MCP extension or compatible MCP client).
3. Install the Sidemail MCP package via npx when configuring the server: npx -y @sidemail/mcp
4. Provide your Sidemail API Key when prompted or configure it in the environment variable SIDEMAIL_API_KEY:
   • In VS Code MCP settings, add SIDEMAIL_API_KEY to the env for sidemail-mcp.
   • Or set it in your IPC/CLI environment before starting the MCP server.

Usage example (CLI):

• Run the MCP server via the standard MCP launcher in your environment. For example: npx @sidemail/mcp

Configuration example (VS Code or Claude/ cursor setups):

• Use the following configuration to start the MCP server and supply your API key:

{
  "servers": {
    "sidemail-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@sidemail/mcp"],
      "env": {
        "SIDEMAIL_API_KEY": "your-sidemail-api-key"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "sidemail-key",
      "description": "Sidemail API Key",
      "password": true
    }
  ]
}

Note: Replace placeholders with your actual API key. The MCP client will communicate with Sidemail through the provided API key to authenticate requests.

Environment variables: SIDEMAIL_API_KEY is required for authentication. Some IDE integrations (VS Code, Claude, Cursor) store this value in their respective config files; ensure you keep it secure and do not commit it to source control.

Common issues:

• Invalid API key: double-check the key and ensure it has the necessary Sidemail permissions.
• Network/proxy problems: ensure outbound access to Sidemail APIs is allowed from your environment.
• Command setup: if using a non-standard shell or terminal, verify that npx is available and the MCP command is reachable.

Commands available under MCP server sidemail-mcp cover Domains, Messenger, Groups, Contacts, and Emails, with operations like list-, create-, update-, and delete- for respective resources.