MCP Setup

Loomal provides a hosted MCP server at https://api.loomal.ai/mcp. No packages to install — just a URL and your API key.

Claude Code

Add to your project's .claude/settings.json or ~/.claude.json:

{
  "mcpServers": {
    "loomal": {
      "url": "https://api.loomal.ai/mcp",
      "headers": {
        "LOOMAL_API_KEY": "mgent-your-api-key"
      }
    }
  }
}

Restart Claude Code. The mail.* and vault.* tools will appear.

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "loomal": {
      "url": "https://api.loomal.ai/mcp",
      "headers": {
        "LOOMAL_API_KEY": "mgent-your-api-key"
      }
    }
  }
}

Smithery

Install via Smithery:

npx @smithery/cli mcp add loomal/loomal --config '{"LOOMAL_API_KEY": "mgent-your-api-key"}'

Any MCP Client

Loomal uses the Streamable HTTP transport (MCP spec). Any client that supports URL-based MCP servers will work:

URL:     https://api.loomal.ai/mcp
Method:  POST (for tool calls), GET (for SSE)
Header:  LOOMAL_API_KEY: mgent-your-api-key

Verify Connection

Once configured, ask your agent:

"What mail tools do you have?"

It should list the available mail.* and vault.* tools based on your identity's scopes.

Next Steps