Email, vault, and TOTP
in Claude Desktop.

1. Get a Loomal API key

Sign up at console.loomal.ai. Create an identity. Copy the API key (loid-...) — you'll paste it into the Claude config in the next step.

# Nothing to install — the API key is the only credential you need.

2. Open Claude's MCP config file

Claude Desktop reads from claude_desktop_config.json. The location depends on your OS:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%\Claude\claude_desktop_config.json. Open it in any text editor; create it if it doesn't exist.

# Open in your editor of choice
code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

3. Add Loomal as an MCP server

Add the Loomal block to mcpServers. If the file is empty, paste the full snippet below. If you already have other MCP servers, add the loomal entry alongside them inside mcpServers.

Paste your loid- key into LOOMAL_API_KEY. Don't quote the npx args — the JSON syntax already handles that.

{
  "mcpServers": {
    "loomal": {
      "command": "npx",
      "args": ["-y", "@loomal/mcp"],
      "env": {
        "LOOMAL_API_KEY": "loid-your-api-key"
      }
    }
  }
}

4. Restart Claude Desktop

Quit Claude completely (Cmd+Q on macOS — closing the window isn't enough) and reopen it. Claude reads MCP config only at startup, so the new server won't show up until you restart.

After restart, you should see a hammer/tools icon in the chat input area indicating MCP tools are available. Click it and you'll see mail.*, vault.*, and identity.* tools listed.

Look for the tools icon ⚒ in the chat input.
Click it → expand 'loomal' → confirm mail.send, mail.list_messages, vault.get, vault.totp are listed.

5. Use it from chat

Talk to Claude as you normally would. When the conversation needs an email, Claude will call the Loomal tool — you'll see a tool-use indicator and a request for permission the first time.

For TOTP and vault flows, pre-load the secrets via the REST API once. Then ask Claude to use them by label.

Send a thank-you email to alice@example.com about today's demo.

What's in my inbox right now?

Reply to the latest support email about billing — the answer is that we prorate refunds.

What's the current 2FA code for the label 'crm-totp'?