Enables management of Messenger drafts with capabilities to list, create, update, and delete drafts programmatically.
Provides the runtime environment required for the MCP server, with v18 or newer needed as a prerequisite.
Used for package distribution and installation of the Sidemail MCP server.
Sidemail Model Context Protocol (MCP) Server
Sidemail MCP Server provides Model Context Protocol (MCP) integration for Sidemail.io, enabling programmatic access to Sidemail's transactional email, contacts, domains, and Messenger features via MCP agent mode in VS Code and other MCP clients.
Features
Manage sending domains
Test sending transactional emails
Manage contacts and groups
Create, update, and delete Messenger drafts
Query sent emails and contacts
Related MCP server: protonmail-mcp
Prerequisites
Node.js v18 or newer
Sidemail API Key
Microsoft VS Code setup (assisted)
Open the Command Palette (
Ctrl/Cmd + Shift + P).Type “MCP: Add Server…” and select it.
Select "NPM Package".
Enter
@sidemail/mcpand confirm it.Confirm the installation.
Enter your Sidemail API key and confirm it.
Microsoft VS Code setup (manual)
Alternatively, you can install it manually by modifying the mcp.json configuration file.
Open the Command Palette (
Ctrl/Cmd + Shift + P).Type “MCP: Open User Configuration” and select it.
Add the configuration below and save changes.
Claude Desktop setup
Edit (or create) the config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
Cursor setup
Create or edit ~/.cursor/mcp.json:
CLI Usage
MCP Server Tools
Domains
list-domains: List all sending domains
create-domain: Add a new sending domain
delete-domain: Remove a sending domain
Messenger
list-messenger-drafts: List Messenger drafts
get-messenger-draft: Get Messenger draft by ID
create-messenger-draft: Create a Messenger draft
update-messenger-draft: Update a Messenger draft
delete-messenger-draft: Delete a Messenger draft
Groups
list-groups: List all contact groups
create-group: Create a new contact group
update-group: Update a contact group
Contacts
create-or-update-contact: Create or update a contact
query-contacts: Query contacts with filters
find-contact: Find a contact by email
delete-contact: Delete a contact
Emails
send-email: Send a transactional email (testing only)
query-emails: Query sent emails