Sidemail MCP

How to Install and Use Sidemail MCP

Sidemail MCP is a tool that helps you use Sidemail.io's email and contact features through your code editor or other MCP clients. Follow these simple steps to get it up and running quickly.

What You Need Before Starting

Before installing Sidemail MCP, make sure you have two things ready:

• Node.js version 18 or newer installed on your computer
• Your Sidemail API Key (you can get this from your Sidemail.io account)

Once you have these, you can move on to the installation.

Installing Sidemail MCP in Visual Studio Code (Easy Way)

If you use Microsoft Visual Studio Code, there is a straightforward way to add Sidemail MCP as a server:

1. Open the Command Palette by pressing Ctrl + Shift + P (or Cmd + Shift + P on Mac).
2. Type MCP: Add Server… and select this option.
3. Choose "NPM Package" from the list.
4. Enter @sidemail/mcp as the package name.
5. Confirm the package installation.
6. When asked, enter your Sidemail API key and confirm.

That’s it! Sidemail MCP will be installed and connected to your Sidemail account.

Installing Sidemail MCP Manually in Visual Studio Code

If you want to set up Sidemail MCP manually, you need to edit the MCP configuration file:

1. Open the Command Palette using Ctrl + Shift + P (or Cmd + Shift + P on Mac).
2. Type MCP: Open User Configuration and open it.
3. Add the following configuration to the file:

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

1. Save the file. This setup will ask for your API key when Sidemail MCP starts.

Setting Up Sidemail MCP with Other Tools

Sidemail MCP can also be used with other apps like Claude Desktop or Cursor by editing their respective config files.

For Claude Desktop, create or edit this config file with your API key:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%Claudeclaude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Add this:

{
  "mcpServers": {
    "sidemail": {
      "command": "npx",
      "args": ["-y", "@sidemail/mcp"],
      "env": { "SIDEMAIL_API_KEY": "your-key" }
    }
  }
}

For Cursor, edit or create ~/.cursor/mcp.json with the same format:

{
  "mcpServers": {
    "sidemail": {
      "command": "npx",
      "args": ["-y", "@sidemail/mcp"],
      "env": { "SIDEMAIL_API_KEY": "your-key" }
    }
  }
}

Replace "your-key" with your actual Sidemail API Key.

Using Sidemail MCP from the Command Line

If you want to try Sidemail MCP directly from the terminal, you can easily run:

npx @sidemail/mcp

This command starts the MCP server and connects it to your Sidemail account.

Summary

• Get Node.js v18+ and your Sidemail API Key ready.
• Use Visual Studio Code’s easy server add or edit mcp.json manually.
• For other apps, configure their MCP settings with your API key.
• Run npx @sidemail/mcp in the terminal to start the server.

Following these steps will make Sidemail MCP work smoothly with your favorite tools, giving you access to Sidemail’s powerful email and contact services right inside your environment.