Hillnote

You can run the Hillnote MCP Server to expose document workspaces to MCP clients, enabling AI assistants to read, edit, and organize your documents, tasks, and AI recipes across multiple workspaces from your Hillnote setup.

How to use

You connect an MCP client to the Hillnote MCP Server to perform CRUD operations on documents, manage workspaces, search content, manipulate markdown, handle tasklists, and run AI prompt recipes. The server is designed to work with dp-enabled clients and supports multiple workspaces, allowing you to centralize control and automation for your documents.

How to install

# Prerequisites
# - macOS
# - Node.js >= 18.0.0
# - Hillnote Desktop App for macOS (required for workspace discovery)

# Option 1: Install from NPM (Recommended)
npm install -g @hillnote/mcp-server

# Verify installation
npm list -g @hillnote/mcp-server

# If using Homebrew Node.js, the files will be in:
# /opt/homebrew/lib/node_modules/@hillnote/mcp-server/

# Option 2: Install from Source
git clone https://github.com/HillnoteApp/hillnote-mcp-server.git
cd hillnote-mcp-server

# Install dependencies (no -g flag here)
npm install

# After installing, you may need to restart your MCP client (Claude Desktop, Cursor, etc.)

Configuration and startup considerations

The MCP server automatically detects all Hillnote workspaces based on your Hillnote app configuration. If you installed via NPM, you can configure the MCP entry in a project-wide configuration file to point to the installed binary.

Two explicit MCP configuration examples are shown for the Hillnote server. Use the one that fits your installation method. The entries illustrate how the MCP client can discover and connect to the Hillnote MCP server.

Maintenance and updates

Keep the MCP server up to date to receive improvements and new features. If you install from NPM, update globally and restart your MCP client after upgrading.

If you install from source, pull the latest changes in your local clone, reinstall dependencies, and restart your MCP client to apply updates.

Security and sandboxing

The server operates within workspace directories with sandboxed file operations. It is designed to avoid network access and include protections against path traversal. All input is validated to minimize risks.

Notes

The Hillnote MCP Server is built to work with MCP clients across macOS environments and will expand to Windows support in a future release. Ensure your client and server versions are compatible to avoid feature differences.

Available tools

list_workspaces

Lists all available workspaces with document counts and metadata.

read_registry

Get complete workspace overview including all documents, folders, and relationships.

read_document

Read a specific document's content and metadata.

add_document

Create a new document with content and metadata.

update_document

Update an existing document's content or metadata.

rename_document

Rename a document and update its file name.

delete_document

Delete a document from the workspace.

search_documents

Search documents with fuzzy matching and smart ranking.

insert_content

Insert content at a specific position with validation.

replace_content

Replace text in a document with preview and occurrence info.

delete_content

Delete content between positions or patterns.

append_to_section

Append content to a specific markdown section.

list_recipes

List all AI prompt recipes in a workspace.

get_recipe

Get a specific recipe by ID.

add_recipe

Create a new AI prompt recipe.

update_recipe

Update an existing recipe.

delete_recipe

Delete a recipe.

create_tasklist

Create a new tasklist (Kanban board) in a workspace.

list_tasklists

List all tasklists in a workspace.

read_tasklist

Read a complete tasklist structure with all task metadata.

add_task

Create a new task in a tasklist.

update_task_status

Move a task to a different column/status.

update_task_metadata

Update task properties (priority, assignments, dates, recurring settings).

add_html_tool

Create an interactive HTML tool in the workspace.

list_html_tools

List all HTML tools in a workspace.

get_html_tool

Get a specific HTML tool's files.

update_html_tool

Update an HTML tool's files.

delete_html_tool

Delete an HTML tool.