Skip to main content
Cursor supports the Model Context Protocol natively, which means connecting Hyper takes less than two minutes and requires no plugins or extensions. Once set up, Hyper gives Cursor’s AI a persistent memory layer — decisions you’ve made, patterns you prefer, and context from past sessions all flow into every new conversation automatically.

​
Add the MCP Server

1

Open Cursor Settings

Launch Cursor and navigate to Settings (gear icon, or Cmd+, on macOS / Ctrl+, on Windows and Linux).
2

Go to Features → MCP Servers

In the left sidebar, click Features, then scroll to the MCP Servers section.
3

Add a new server

Click Add new MCP server and fill in the following fields:Click Save to apply the configuration.
4

Authenticate with Google

The first time Cursor calls a Hyper tool, an OAuth 2.0 flow launches in your browser. Sign in with Google to authorize access. Your token is saved to ~/.hyper/token and reused for all future sessions — you won’t be prompted again.
Cursor stores MCP server configurations in its internal settings database, so there’s no JSON file to edit manually. The UI in Features → MCP Servers is the canonical way to manage servers.

​
Verify the Connection

Once the server is saved, confirm Hyper is live before you rely on it in a real project.
1

Open Cursor Chat

Press Cmd+L (macOS) or Ctrl+L (Windows/Linux) to open the AI chat panel.
2

Send a connect message

Type the following and press Enter:
3

Confirm the briefing

Cursor’s AI will call the connect tool and return a workspace briefing similar to this:
If you see a structured briefing like this, Hyper is fully operational.
After a successful connection, try asking Cursor something that references past work — for example, “What decisions have we made about the auth system?” — to confirm that memory retrieval is working end-to-end.

​
How Hyper Enhances Cursor’s AI

With Hyper connected, Cursor’s AI gains capabilities it doesn’t have out of the box:

Persistent Context

Memories from past sessions are available in every new chat — no more re-explaining your stack or conventions.

Team Knowledge

Shared workspaces mean your teammates’ discoveries and decisions are part of Cursor’s context too.

Project Identity

Hyper knows which project you’re in and loads the right workspace automatically when you connect.

Selective Memory

Use Incognito Mode to pause memory writes whenever you’re working on something sensitive.

​
Troubleshooting

If the hyper server shows as disconnected in Cursor’s MCP panel, check that the URL is entered exactly as shown — no trailing slash, and https:// (not http://) for the production server.

​
Local Development

If you’re running a local Hyper instance for development or testing, use the local URL instead: Add this as a second server entry alongside the production one, and switch between them as needed directly in the MCP Servers panel.