KosmoKrator

productivity

Mailtrap MCP Integration for Codex

Connect Mailtrap to Codex through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write API token auth
Submit Mailtrap feedback View package source

Connect Mailtrap to Codex

Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.

Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with --write=deny so Codex can inspect read-capable tools without receiving write access by default.

Mailtrap MCP Config for Codex

Keep write access denied or ask-based unless the workspace is trusted.

{
  "mcpServers": {
    "kosmokrator-mailtrap": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=mailtrap",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=mailtrap --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Mailtrap instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Mailtrap Tools Visible to Codex

Codex sees stable MCP tool names generated from the Mailtrap integration catalog.

MCP toolSource functionTypeDescription
integration__mailtrap__mailtrap_list_inboxes mailtrap.mailtrap_list_inboxes Read List all inboxes in the Mailtrap account. Returns inbox IDs, names, and email addresses.
integration__mailtrap__mailtrap_get_inbox mailtrap.mailtrap_get_inbox Read Get details for a specific Mailtrap inbox by ID, including its email address, settings, and message counts.
integration__mailtrap__mailtrap_list_messages mailtrap.mailtrap_list_messages Read List messages in a Mailtrap inbox with optional search and pagination.
integration__mailtrap__mailtrap_get_message mailtrap.mailtrap_get_message Read Get a single message from a Mailtrap inbox by its ID, including subject, sender, recipient, and body.
integration__mailtrap__mailtrap_send_test_email mailtrap.mailtrap_send_test_email Write Send a test email through Mailtrap. Provide sender, recipient(s), subject, and either text or HTML body.
integration__mailtrap__mailtrap_list_suppressions mailtrap.mailtrap_list_suppressions Read List suppressions (blocked recipients) for a Mailtrap inbox.
integration__mailtrap__mailtrap_get_current_user mailtrap.mailtrap_get_current_user Read Get the current Mailtrap user profile and account info. Useful as a health check.

Related Mailtrap Pages

Mailtrap CLIUse direct JSON commands instead of MCP discovery. Mailtrap MCPFull gateway reference and MCP tool names. KosmoKrator for CodexClient-level gateway setup.