Set up your AI agent
Connect your AI agent
Give Claude, Cursor, ChatGPT, Perplexity, Windsurf, or any MCP-capable agent its own Lumbox inbox. Sign in over OAuth in the browser, no API key required, or pass a key for headless setups.
Claude Desktop, claude.ai, and Claude Code.
Connect with OAuth (no API key)
- 1
Open Claude connectors
In claude.ai or the desktop app, go to Settings > Connectors.
- 2
Add a custom connector
Click Add custom connector, name it Lumbox, and paste this URL:
https://mcp.lumbox.co/mcp - 3
Connect and sign in
Click Add > Connect, sign in with your Lumbox account, and approve. No API key needed.
No browser? Use an API key
For Claude Code or headless setups.
- 1
Add over HTTP (OAuth)
In a terminal:
claude mcp add --transport http lumbox https://mcp.lumbox.co/mcp - 2
Or run the npm package with a key
Add to your .mcp.json or claude_desktop_config.json:
{ "mcpServers": { "lumbox": { "command": "npx", "args": ["-y", "--package=@lumbox/mcp-server", "lumbox-mcp"], "env": { "LUMBOX_API_KEY": "ak_your_key_here", "LUMBOX_API_URL": "https://api.lumbox.co" } } } }