Repository navigation
AI Agents
BlizzHacker edited this page Nov 17, 2026
·
1 revision
ROMarr includes an MCP server, so Claude, Codex, Hermes, Antigravity and other MCP clients can read your library and activity. Open Hub → AI Agents for a ready-to-copy connection example for your client.
https://YOUR-ROMARR/api/v1/mcp
It requires your ROMarr API key (Settings → General), sent as X-Api-Key or a bearer token. Use HTTPS or an SSH tunnel for connections from other machines.
- Read-only by default: cached library, activity, history, platforms and counts.
- A server owner can explicitly allow two writes: adding a Wanted entry and requesting a background library refresh.
- The connector never runs shell commands, browses files, controls your desktop, or forwards arbitrary API calls.
{
"mcpServers": {
"romarr": {
"type": "http",
"url": "https://YOUR-ROMARR/api/v1/mcp",
"headers": { "X-Api-Key": "<YOUR_ROMARR_API_KEY>" }
}
}
}A portable stdio bridge is available for clients that don't speak HTTP, such as Claude Desktop.
Full guide with Codex, Hermes and Antigravity examples: MCP.md.
ROMarr is MIT licensed · Report a problem · Detailed, release-tracked docs live in the repository's docs folder.