Connecting Your Coding Tool

Momental exposes its tools over the Model Context Protocol (MCP). Any MCP client connects to the same server at https://mcp.momentalos.com/mcp/v3. This page gives the exact config for each supported client.

You need an API key first. Sign in at app.momentalos.com and go to Settings → API Keys → Generate key. Keys start with mmt_. Replace mmt_your_key_here in every config below with your real key. See Authentication for scopes and rotation.

Two Transports

Most clients support an HTTP transport that talks to the server directly. A few only support stdio, so Momental also ships an npm proxy that bridges stdio to the same HTTP server. Use whichever your client supports.

HTTP Transport

The client connects straight to the server and sends your key in an Authorization: Bearer header.

{
  "mcpServers": {
    "momental": {
      "type": "http",
      "url": "https://mcp.momentalos.com/mcp/v3",
      "headers": {
        "Authorization": "Bearer mmt_your_key_here"
      }
    }
  }
}

stdio Transport (npm proxy)

For clients that only speak stdio, run the @momentalos/mcp package. It reads your key from the MOMENTAL_API_KEY environment variable and forwards every call to the same server.

{
  "mcpServers": {
    "momental": {
      "command": "npx",
      "args": ["-y", "@momentalos/mcp@latest"],
      "env": {
        "MOMENTAL_API_KEY": "mmt_your_key_here"
      }
    }
  }
}

Per-Client Setup

Claude Code

Add the server from the CLI with the HTTP transport:

claude mcp add --transport http momental https://mcp.momentalos.com/mcp/v3 \
  --header "Authorization: Bearer mmt_your_key_here"

Cursor

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project:

{
  "mcpServers": {
    "momental": {
      "url": "https://mcp.momentalos.com/mcp/v3",
      "headers": {
        "X-Api-Key": "mmt_your_key_here"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your project:

{
  "servers": {
    "momental": {
      "type": "http",
      "url": "https://mcp.momentalos.com/mcp/v3",
      "headers": {
        "X-Api-Key": "mmt_your_key_here"
      }
    }
  }
}

Claude Desktop

Claude Desktop uses the stdio proxy. Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "momental": {
      "command": "npx",
      "args": ["-y", "@momentalos/mcp@latest"],
      "env": {
        "MOMENTAL_API_KEY": "mmt_your_key_here"
      }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "momental": {
      "serverUrl": "https://mcp.momentalos.com/mcp/v3",
      "headers": {
        "X-Api-Key": "mmt_your_key_here"
      }
    }
  }
}

Claude.com Web App

The Claude.com web app connects to Momental as a custom connector over OAuth. There is no API key to paste — the connector authorizes against your logged-in Momental session.

1. In Claude.com, open the connector settings and choose Add custom connector.
2. Paste the MCP URL https://mcp.momentalos.com/mcp/v3.
3. Authorize when prompted. Claude.com runs the OAuth flow and the connector is linked to your Momental account.

Verify

After connecting, call the whoami tool. You get back your identity, assigned tasks, and team context, which confirms the connection works.