Connect HERO to your AI tool
Plug HERO into Claude Desktop, Cursor, Claude Code, and other AI tools.
What HERO can do once it's connected
Your AI tool gets the same access to HERO as you do.
Read & search
Pull document text, search across workspaces, list project trees, and read clauses by numbering.
Write & edit
Create new documents, append content, surgically edit specific blocks, or replace whole documents using extended markdown.
Tables & templates
Read table data, add rows, update cells, and build smart legal templates with live placeholders pulled from your tables.
Manual setup
Setting up a different AI tool? Drop the config below in.
You'll need a HERO API key from your settings page.
{
"mcpServers": {
"hero": {
"command": "npx",
"args": ["-y", "@myhero/mcp-server"],
"env": { "HERO_API_KEY": "hero_at_..." }
}
}
}Manual setup guide
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows.
Add the hero server inside mcpServers.
OAuth alternative: omit the env block and the bridge will open your browser to log in on first use.
Cursor
Open Cursor settings → MCP → Add new MCP server, paste:
{
"command": "npx",
"args": ["-y", "@myhero/mcp-server"],
"env": { "HERO_API_KEY": "hero_at_..." }
}Claude Code (CLI)
claude mcp add hero -- npx -y @myhero/mcp-serverThen either set HERO_API_KEY in your shell or let the first call open the OAuth login.
Other stdio MCP clients
npx -y @myhero/mcp-serverSet HERO_API_KEY in the environment to skip the OAuth login.
Remote MCP (no install)
If your client supports remote MCP with OAuth discovery, point it at https://app.myhero.so/api/mcp/. OAuth metadata is at https://app.myhero.so/.well-known/oauth-authorization-server.
FAQ
Do I need to use a terminal?
No. The one-click installs above set everything up for Cursor and Claude Desktop. The terminal is only needed for Claude Code or other CLI-based tools.
How do I revoke an AI tool's access?
Go to Settings → MCP Tokens in HERO. You'll see every active session and personal token, and can revoke any of them with one click.
Can I limit which workspaces an AI tool can access?
Yes. When you generate a token (or click Authorize during OAuth login), you choose either all workspaces or a specific subset. Tokens never see workspaces you didn't grant.
Is my data sent anywhere besides HERO?
The HERO MCP server runs locally on your machine and talks directly to HERO over HTTPS. Your AI tool sees only what it asks for, scoped to whatever your token allows.