How to Install ox-mcp MCP in Cursor

To install the ox-mcp MCP server in Cursor, click the install button below (deep-link) — Cursor opens and adds the server. No JSON editing needed.

Install link

cursor://anysphere.cursor-deeplink/mcp/install?name=ox-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkByaGVvcHlyaW4vb3gtbWNwIl0sImVudiI6eyJPWF9NQ1BfQUNDT1VOVFMiOiIiLCJPWF9NQ1BfQ0FMREFWX0FQUF9QQVNTV09SRCI6IiIsIk9YX01DUF9DQUxEQVZfU0VSVkVSIjoiIiwiT1hfTUNQX0NBTERBVl9VU0VSIjoiIiwiT1hfTUNQX0RFRkFVTFRfU0VSVkVSIjoiIiwiT1hfTUNQX0VOQUJMRV9DQUxEQVYiOiIiLCJPWF9NQ1BfRU5BQkxFX0NBTEVOREFSX1JFU1BPTkRfRVZFTlQiOiIiLCJPWF9NQ1BfRU5BQkxFX0VNQUlMX1NFTkQiOiIiLCJPWF9NQ1BfTUFJTF9BUFBfUEFTU1dPUkQiOiIiLCJPWF9NQ1BfTUFJTF9TRVJWRVIiOiIiLCJPWF9NQ1BfTUFJTF9VU0VSIjoiIiwiT1hfTUNQX1BFUlNPTkFMX0NBTERBVl9BUFBfUEFTU1dPUkQiOiIiLCJPWF9NQ1BfUEVSU09OQUxfQ0FMREFWX1NFUlZFUiI6IiIsIk9YX01DUF9QRVJTT05BTF9DQUxEQVZfVVNFUiI6IiIsIk9YX01DUF9XT1JLX0VOQUJMRV9DQUxFTkRBUl9DUkVBVEVfRVZFTlQiOiIiLCJPWF9NQ1BfV09SS19NQUlMX0FQUF9QQVNTV09SRCI6IiIsIk9YX01DUF9XT1JLX01BSUxfU0VSVkVSIjoiIiwiT1hfTUNQX1dPUktfTUFJTF9VU0VSIjoiIn19

1-click install via Unyly

1
Click the install button
Cursor opens automatically.
2
Confirm
Approve adding the MCP server.
3
Done
The server is connected; a restart is usually not required.

Where the config lives

Cursor reads MCP servers from ~/.cursor/mcp.json (global — all projects) or .cursor/mcp.json in a project root (that project only). The install deep-link writes the global file.

Project vs global scope

The global file makes the server available everywhere; a project .cursor/mcp.json scopes it to that repo and can be committed so your team gets it automatically.

API keys & environment variables

This server needs environment variables: OX_MCP_ACCOUNTS, OX_MCP_CALDAV_APP_PASSWORD, OX_MCP_CALDAV_SERVER, OX_MCP_CALDAV_USER, OX_MCP_DEFAULT_SERVER, OX_MCP_ENABLE_CALDAV, OX_MCP_ENABLE_CALENDAR_RESPOND_EVENT, OX_MCP_ENABLE_EMAIL_SEND, OX_MCP_MAIL_APP_PASSWORD, OX_MCP_MAIL_SERVER, OX_MCP_MAIL_USER, OX_MCP_PERSONAL_CALDAV_APP_PASSWORD, OX_MCP_PERSONAL_CALDAV_SERVER, OX_MCP_PERSONAL_CALDAV_USER, OX_MCP_WORK_ENABLE_CALENDAR_CREATE_EVENT, OX_MCP_WORK_MAIL_APP_PASSWORD, OX_MCP_WORK_MAIL_SERVER, OX_MCP_WORK_MAIL_USER. Put your real values in the env block (Cursor / VS Code / Claude Desktop) or as -e KEY=value flags (Claude Code). Keep them in env, not args — otherwise the secrets leak into logs.

Verify it works

Open Cursor → Settings → MCP — the server should be listed with a green indicator. A red one means it failed to start.

If the tools don’t appear

· Restart Cursor fully (not just the window).
· Check the command/config for typos; validate the JSON if applicable.
· Make sure Node.js or uv is installed (for npx/uvx servers).
· Check Cursor’s logs — the server may have crashed on start (missing env var, bad token).

How many servers is too many

Every connected server adds its tools to the model’s context. Past ~40–60 tools, selection accuracy drops. Keep only the servers you use enabled, or reach the whole catalog through a gateway — one connection instead of dozens.

Removing ox-mcp

Remove the entry from ~/.cursor/mcp.json (or the project file), or toggle it off in Cursor → Settings → MCP.

Install ox-mcp in another client

VS Code Claude Code Claude Desktop

FAQ

Do I need to edit JSON by hand?

No. In Cursor it's a command or a deep-link; on Unyly the Install button writes the config for you.

Where is the Cursor config file?

Cursor keeps MCP servers in its own settings — installing via command/button means you never touch a file by hand.

The MCP isn’t showing up — what do I do?

Restart Cursor, check the command/config for typos, and make sure Node.js / a package runner is installed if the server runs via npx/uvx.

How do I update ox-mcp?

Servers run via npx/uvx pull the latest version on launch. Otherwise, reinstall the same way.

Is it safe to install ox-mcp?

An MCP server runs with your client’s permissions and access to its data. Install it with the same caution as any npm package: check the source and keep secrets in env. Verified servers on Unyly have passed a security scan.

Does ox-mcp cost anything?

Browsing and installing on Unyly is free. The server itself may need a third-party API key — that’s billed by the service, not by Unyly.

Can I use ox-mcp in ChatGPT or claude.ai?

Not directly: ox-mcp is a local (stdio) server, and ChatGPT/claude.ai only accept remote MCPs. Use the Unyly gateway to expose local servers as one remote endpoint.

Command Palette