Spatial understanding for your agents.
openreality-mcp gives Claude Code, Codex, and Cursor tools to upload captures, reconstruct scenes, measure geometry, query objects, and build spatial applications.
Open source (BSD-2-Clause): github.com/reality-opened/openreality
Login and install
Installs the harness locally, then opens your browser and stores a revocable API key. Every client below picks it up automatically. Every client will have access to the same scenes and data.
npx -y openreality-mcp loginClaude
claude mcp add openreality -- npx -y openreality-mcp serveClaude Desktop
Add this to claude_desktop_config.json under Settings → Developer → Edit Config.
{
"mcpServers": {
"openreality": {
"command": "npx",
"args": ["-y", "openreality-mcp", "serve"]
}
}
}Codex
codex mcp add openreality -- npx -y openreality-mcp serveOr add this to ~/.codex/config.toml. The Codex IDE extension reads the same file.
[mcp_servers.openreality]
command = "npx"
args = ["-y", "openreality-mcp", "serve"]Cursor
Or add this to ~/.cursor/mcp.json, or .cursor/mcp.json inside a project.
{
"mcpServers": {
"openreality": {
"command": "npx",
"args": ["-y", "openreality-mcp", "serve"]
}
}
}Remove the harness.
Drop the MCP server from each client. Stored credentials stay until you delete them or revoke the key from the dashboard.
Claude Code
claude mcp remove openrealityClaude Desktop: delete the openreality entry from claude_desktop_config.json.
Codex
codex mcp remove openrealityCursor
Cursor Settings → MCP, then remove openreality. Or delete that entry from ~/.cursor/mcp.json or .cursor/mcp.json.
Credentials
Login writes ~/.config/openreality/credentials.json. Delete that file to sign out locally, and revoke the key from the dashboard API keys section if you want it gone server-side.