MCP Setup
Connect your AI agent to Loomal via Model Context Protocol
Install the @loomal/mcp package to connect any MCP-compatible AI client to Loomal.
Claude Code
claude mcp add loomal -- npx -y @loomal/mcpSet the LOOMAL_API_KEY environment variable when prompted. Or add to your .claude/settings.json or ~/.claude.json:
{
"mcpServers": {
"loomal": {
"command": "npx",
"args": ["-y", "@loomal/mcp"],
"env": {
"LOOMAL_API_KEY": "loid-your-api-key"
}
}
}
}Restart Claude Code. The identity.*, mail.*, vault.*, and calendar.* tools will appear based on your identity's scopes.
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"loomal": {
"command": "npx",
"args": ["-y", "@loomal/mcp"],
"env": {
"LOOMAL_API_KEY": "loid-your-api-key"
}
}
}
}Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"loomal": {
"command": "npx",
"args": ["-y", "@loomal/mcp"],
"env": {
"LOOMAL_API_KEY": "loid-your-api-key"
}
}
}
}Smithery
Install via Smithery:
npx @smithery/cli mcp add loomal/identity --config '{"LOOMAL_API_KEY": "loid-your-api-key"}'Any MCP Client
@loomal/mcp is a standard stdio MCP server. Any client that supports command-type MCP servers will work:
{
"command": "npx",
"args": ["-y", "@loomal/mcp"],
"env": {
"LOOMAL_API_KEY": "loid-your-api-key"
}
}Get your API key from console.loomal.ai.
Platform Mode
Use a platform key (lopk-) to manage all identities in your org:
{
"mcpServers": {
"loomal-platform": {
"command": "npx",
"args": ["-y", "@loomal/mcp"],
"env": {
"LOOMAL_API_KEY": "lopk-your-platform-key"
}
}
}
}This exposes identities.* tools for creating, deleting, and managing agent identities.
Verify Connection
Once configured, ask your agent:
"What mail tools do you have?"
It should list the available identity.*, mail.*, vault.*, and calendar.* tools based on your identity's scopes.