Cursor

Make Cursor’s AI understand your work. One Horizon captures your assigned issues (from tools like Jira or Linear) into the editor, so the AI knows what you’re working on and can help you write better code. When you finish something, it can auto-log what you did to your Done List.

Configuration

You can configure One Horizon for a single project or for all projects on your machine.

Just for you

Open Cursor Settings and search for Tools & Integrations. Press the New MCP Server button.

This should open a new window with a configuration file that is located in your home directory.

~/.cursor/mcp.json

Paste the following JSON into your chosen configuration file. This registers the One Horizon remote MCP server in Cursor.

{  "mcpServers": {    "onehorizon": {      "command": "npx",      "args": [        "mcp-remote@latest",        "https://mcp.onehorizon.ai/mcp"      ]    }  }}

Project

You can also configure One Horizon for a project. Create a configuration file at the root of your repository inside the .cursor directory.

.cursor/mcp.json

Paste the same JSON into your this configuration file.

{  "mcpServers": {    "onehorizon": {      "command": "npx",      "args": [        "mcp-remote@latest",        "https://mcp.onehorizon.ai/mcp"      ]    }  }}

Activate in Cursor

Open a chat in Cursor and enable the One Horizon tool if it is not already active.

Ask, for example, "show my planned work for this week".

The first call may take a moment while tools and schemas are loaded.

Authentication

Cursor will prompt you to authenticate when the server requests it. A browser window will open asking you to connect and log in to verify the connection. After successful authentication, the One Horizon tools will be available in your Cursor chat.

What you can ask Cursor

“show my assigned issues and tasks for today”

Cursor uses One Horizon to pull your in-flight issues from tools like Linear or Jira and summarizes them.

“use my assigned task details for the gateway API”

Cursor pulls those details into context so the AI writes code with the right scope and names.

“log this work to my Done List”

Cursor summarizes what it just wrote and adds a concise entry to your Done List.

Security and permissions

The connector acts on your behalf. Data access follows your One Horizon roles, workspace membership, and scopes.

Troubleshooting

Cursor reports that no tools are available

Confirm the JSON syntax, the file location, and that the URL matches exactly. Restart Cursor after adding or changing the configuration file. If you still cannot connect, verify that outbound HTTPS to mcp.onehorizon.ai is allowed by your network.

Endless Authentication loop

In some cases, Cursor may get stuck in an endless authentication loop. If this happens make sure you only have one MCP server configured for One Horizon.

It can also happen that our system is blocking the connection due to a rate limit. If this happens, simply wait a couple of minutes and try again.

Other Authentication issues

If authentication fails, try clearing your browser cookies and restarting Cursor. Ensure you're using the correct One Horizon account credentials.