A Model Context Protocol (MCP) server that enables seamless integration between Claude and Hulunote, a powerful bidirectional linking note-taking application.
- Browse Databases: List all available databases (notebooks)
- Create Notes: Generate new notes in any Hulunote database
- Manage Outline Nodes: Create, update, and delete hierarchical navigation structures within notes
- Retrieve Notes: Access and list notes from your databases with pagination support
- Bulk Operations: Fetch all notes or navigation nodes for comprehensive knowledge management
| Tool | Description |
|---|---|
get_database_list |
List all databases for the authenticated user |
| Tool | Description |
|---|---|
create_note |
Create a new note in a database |
get_notes |
Get paginated list of notes |
get_all_notes |
Get all notes (not paginated) |
update_note |
Update a note's title/content |
delete_note |
Soft delete a note |
| Tool | Description |
|---|---|
create_or_update_nav |
Create or update an outline node |
get_note_navigation |
Get all outline nodes for a note |
delete_nav |
Soft delete an outline node |
get_all_navigation_nodes |
Get all outline nodes in a database (paginated) |
- Python 3.10 or higher
- pip
- Clone this repository:
git clone https://github.com/xlisp/hulunote-mcp-server.git
cd hulunote-mcp-server- Install dependencies:
pip install -r requirements.txt- Set your API token:
export HULUNOTE_API_TOKEN="your-jwt-token-here"To get your token: log in to Hulunote, open browser DevTools > Network tab, and copy the x-functor-api-token header value from any API request.
Add to your claude_desktop_config.json:
{
"mcpServers": {
"hulunote": {
"command": "python",
"args": ["/path/to/hulunote-mcp-server/hulunote_mcp.py"],
"env": {
"HULUNOTE_API_TOKEN": "your-jwt-token-here"
}
}
}
}List my Hulunote databases
Create a note titled "Project Ideas" in database 0a1e78c8-...
Add an outline node saying "This is a great bidirectional linking note!" to the note
This server uses the x-functor-api-token header for authentication with the Hulunote API at https://www.hulunote.top. The token is a JWT issued upon login.
MIT