Connect it
Claude Code
# remote server, sign in with your Mektup account (OAuth)
claude mcp add --transport http mektup https://mcp.usemektup.com/mcp
# or with an API key
claude mcp add --transport http mektup https://mcp.usemektup.com/mcp \
--header "Authorization: Bearer mek_live_..."Cursor, Claude Desktop and other JSON configs
{
"mcpServers": {
"mektup": {
"url": "https://mcp.usemektup.com/mcp",
"headers": { "Authorization": "Bearer mek_live_..." }
}
}
}{
"mcpServers": {
"mektup": {
"command": "npx",
"args": ["-y", "mektup-mcp"],
"env": { "MEKTUP_API_KEY": "mek_live_..." }
}
}
}Lovable, Replit and Base44 ask for the same three things: the server URL, Bearer authentication and your key, or they run the OAuth sign-in for you. API keys are created in the dashboard under API keys.
The tools
Every endpoint of the Mektup REST API is also a tool, so an agent can do everything a person can do in the dashboard.
| Group | Tools |
|---|---|
| Domains | create_domain get_domain_records verify_domain list_domains delete_domain |
| Mailboxes | create_mailbox list_mailboxes reset_mailbox_password delete_mailbox set_mailbox_webhook get_mailbox_webhook delete_mailbox_webhook |
send_email list_messages get_message get_thread update_message delete_message download_attachment get_unread_counts get_delivery_stats | |
| Drafts | create_draft update_draft get_draft list_drafts delete_draft |
| Organising | create_folder list_folders delete_folder create_contact list_contacts update_contact delete_contact |
| Settings | set_identity get_identity set_vacation get_vacation add_forward list_forwards remove_forward |
| Account | get_me get_usage create_api_key list_api_keys revoke_api_key |
What an agent can do with it
- Set up email for a new project in one session:
create_domain, add the records it returns at the DNS host,verify_domain,create_mailbox. - Work an inbox:
list_messagesfor unread threads,get_threadfor the conversation,send_emailfor the answer,update_messageto mark it read or move it. - Draft for a person to approve:
create_draftinstead of sending; the draft appears in the mailbox for someone to check and send. - Watch deliverability:
get_delivery_statsshows sent, deferred and bounced mail with the receiving server's own answer.
How it runs
The remote server is stateless: each tool call is one request to api.usemektup.com with your token, so it sees exactly what your account sees and nothing else. OAuth clients discover sign-in automatically (RFC 9728 and RFC 8414 metadata, dynamic client registration) and show a consent screen before anything is granted. The same tool definitions run in the local npm package. Mektup is listed in the Official MCP Registry, Smithery, Cursor Directory and mcp.so.