Connect your agent

Connect any other MCP client

Any app that speaks MCP over HTTP can use Clam. Give it two values from your Shell's Install tab, the address and a key, and your Shell's rules decide what it may do.

Before you start

An MCP client is an AI app that can plug in outside tools. Clam is one such tool; it checks every request against your Shell's rules before anything touches Gmail.

Your app must support a remote MCP server over HTTP, which some apps call Streamable HTTP, with a Bearer key on every request. We don't support SSE, and an app with nowhere to put a key can't use Clam.

You also need a Shell; the Quickstart gets you one. Open it, go to its Install tab, and pick Other.

Connect your app

Two ways in. Start with the first; the other is for when it doesn't fit.

Recommended

For any app that speaks MCP over HTTP. The method shows the two values your app needs: the URL, your Shell's own address, and the Key, made when you copy it and good for this app only.

Find where your app adds an MCP server

Usually under Settings, Integrations or Tools.
Give it this link and key

Paste the URL as the address, and the key where the app asks for a token or an Authorization header.

Then ask your app to read your inbox (see Try it), and click Check connection.

If your app takes a block of configuration instead, most read this shape under mcpServers. The Install tab fills in your real values; the placeholders show where each goes.

Paste this block into your app's configuration

Under mcpServers. Keep the type line, or some apps read the entry as a local tool and skip it.

JSON

{
  "mcpServers": {
    "<your Shell's server name>": {
      "type": "http",
      "url": "<your Shell's address>",
      "headers": { "Authorization": "Bearer <your key>" }
    }
  }
}

Then ask your app to read your inbox (see Try it), and click Check connection.

Connect any other MCP client

Before you start

Connect your app

Try it

Remove access

If it doesn't work