hillnote

Hillnote MCP Server exposes a set of tools to manage Hillnote workspaces and documents from any MCP-compatible client. The server supports multi-workspace management, document CRUD operations, smart search, content manipulation, AI recipe handling, HTML tool generation, tasklist and slide/canvas features, and rich metadata support. You can list workspaces, read or modify documents, perform fuzzy searches across your workspace data, and use specialized operations like inserting or replacing content with validation and preview. Configuration is discovered from Hillnote's app data, and client integrations (Claude Desktop, Cursor, VS Code, etc.) can be wired to point at the hillnote MCP server using the provided configuration snippets.

Prerequisites:

• macOS (Hillnote Platform) with Hillnote Desktop App installed
• Node.js >= 18.0.0
• MCP-compatible client (Claude Desktop, Cursor, VS Code, etc.)

Option 1: Install from NPM (Recommended)

1. Install the MCP server globally:

npm install -g @hillnote/mcp-server

2. Verify installation:

npm list -g @hillnote/mcp-server

3. Find global path if needed (for example, Homebrew Node):

# Path example
npm root -g

Option 2: Install from Source

1. Clone the repository:

git clone https://github.com/HillnoteApp/hillnote-mcp-server.git
cd hillnote-mcp-server

2. Install dependencies (no -g flag):

npm install

3. Run the server as needed (see mcp_config for usage in your client):

# Example: if running directly with Node and an entry script
node index.js

Notes:

• The MCP server automatically discovers Hillnote workspaces from the app config at: ~/Library/Application Support/Hillnote/workspaces.json
• For NPM installations, use the global path to point your MCP client (Claude Desktop, Cursor) to the hillnote MCP server configuration.
• If you update the server, restart your MCP client to ensure it picks up changes.
• If you encounter issues, clear npm cache and reinstall, then fully quit and reopen your MCP client.
• The provided configuration example targets the npm-installed binary name hillnote-mcp; if you install from source, you may need to adjust the command and path accordingly.
• Client configuration sections (Claude Desktop, Cursor, VS Code) describe where to place the mcpServers snippet to enable integration.