Connect your tools
While a more extensive set of guides is available at hillnote.com/connect, there are 3 easy ways to integrate your workspace with your AI tools: MCP, the hillnote command, or the workspace folder itself. Once connected, they can read, search, create and edit the pages in your workspaces.
Help can walk you through MCP and the hillnote command: click ? in the top bar and choose Connect your tools.
Via MCP
Fairly straightforward - connect your AI apps to Hillnote's local or cloud MCP server. All the instructions you need are in Settings ▸ Connections. New to MCP? Open What is MCP? at the top. Some apps call them "Connectors", "Plugins" or "Connections".
- Local MCP: AI apps on this computer connect to the MCP server built into Hillnote, and your data stays on your computer. Open the Local MCP card and find your app under CONNECT AN AGENT APP. Click Configure, check the change Hillnote will make to the app's settings file, then click Save Configuration and restart the app. More in Local MCP.
- Cloud MCP: AI apps on any device connect over the web to your synced workspaces, so you will need to sync the workspace first. Copy
https://hillnote.com/mcpfrom the Cloud MCP card and add it in your AI app as a custom connector. Then sign in to Hillnote and click Allow access. More in Cloud MCP.

To check it works, ask your AI app: Add a note called Hello to my Hillnote workspace. Then look for the new page in your workspace. If nothing happens, restart the AI app: many apps only load new connections when they start.
Apps Hillnote can set up for you
Local MCP is desktop app only: the web app at app.hillnote.com doesn't have it. The CONNECT AN AGENT APP grid on the Local MCP card covers Claude Desktop, Claude Code, Cursor, Windsurf, VS Code (Copilot), Gemini CLI, Zed and Codex CLI. Apps found on this computer show Detected and come first.
After you click Configure, you can edit the change before you save it. Connected apps show Configured; use Reconfigure to redo one. If an app's settings file contains comments, click Copy Snippet and paste it in yourself. For other MCP apps, Copy the configuration on the card. Nothing else needs installing.

Cloud MCP access
Cloud MCP needs no setup on this computer and works from any device. When you sign in, check whether the app asks for read-only or read & write access before you click Allow access: with read-only access, it can't change anything. The app can reach the synced workspaces you own or were invited to. To sync one, see Sign-in to sync and unlock premium features!.
To disconnect, remove Hillnote from your AI app's connectors.

Via the command line
Agents that work in a terminal can use the hillnote command instead. It gives them the same tools as the MCP server, with nothing to configure. Agents that Hillnote launches in its own terminals can use it already. For your own terminal, click Install under Command line in Settings ▸ Connections (if your shell can't find the command yet, click Add the line).
Then open a new terminal window and run hillnote status. It shows the workspace, what you have open and what the workspace contains. hillnote --help lists every command, and hillnote doctor checks your setup and says what to fix.
Like local MCP, the command line is desktop app only.

Directly via Files
You could alternatively choose to open the workspace folder directly within the app of your choice and start working there. All context needed by the AI tools is available here: every workspace has an agents.md and a CLAUDE.md at its top level that tell any agent how the workspace is organised and how to work in it. Hillnote writes them and refreshes them after updates. To use your own instructions, replace a file's entire contents. Hillnote's automatic refreshes never overwrite a file it didn't write. Opening a folder as a workspace, or changing the workspace's name or description in Edit Workspace, does rewrite both files, though, so keep a copy of yours.

Hillnote can also start agent CLIs in the workspace folder for you: Claude Code, Cursor, Codex, Antigravity and GitHub Copilot. Open the Terminal panel from the top bar and pick one, or type @claude (or another agent's name) and your request in any page. The agent runs on your own account, and its answer appears below your request. See Agents in your workspace.

Let agents drive the app
Desktop app only. Agent interface control, in Settings ▸ Connections, lets agents connected through local MCP open documents, switch workspaces and show their activity while they work. It's on unless you turn it off.
The first time an agent tries, Hillnote asks Allow “…” to control Hillnote? Choose Allow or Don’t allow. Hillnote remembers your choice. To change it later, use Block or Allow under CONNECTED AGENTS.

Computer use mode, also in Settings ▸ Connections, is for a computer set up to run AI agents:
- Updates install automatically. Hillnote restarts once it has been idle for a few minutes, so an agent at work isn't cut off.
- Agents work without approval prompts. Agents you've blocked stay blocked.
- Every synced workspace syncs as soon as it changes.
When a connection doesn't work
If restarting the AI app doesn't help:
- Run
hillnote doctorin a terminal. It checks the command, the workspace and the link to the running app. - For Cloud MCP, check that the workspace is synced and that you allowed read & write access.
See Fix common problems for more fixes.

The Hillnote skill
Some AI apps can load skills: small folders of instructions they read when a topic comes up. The optional Hillnote skill teaches an app Hillnote's file formats, tools and common fixes. It works alongside local MCP, Cloud MCP or a plain workspace folder. The Hillnote skill page lists the apps it supports and how to install it.