Blues Notehub MCP Server (Python)

What is Blues Notehub MCP Server (Python)?

Blues Notehub MCP Server (Python) is a Model Context Protocol (MCP) server that uses the official notehub_py SDK to interact with the Blues Notehub API. It enables large language models to access and manage Blues Notehub projects, devices, and data.

How to use Blues Notehub MCP Server (Python)?

Install dependencies with pip or uv, then run python notehub.py. Provide your Notehub username (email) and password to the tools when prompted. The server uses X-Session-Token authentication and automatically caches the token for 29 minutes. Connect it to an MCP client like Claude for Desktop by configuring the client’s JSON config file with the command to run the server.

Key features of Blues Notehub MCP Server (Python)

• Lists all accessible Notehub projects (get-projects)
• Fetches devices for a project with optional filtering (get-project-devices)
• Retrieves events for a project with optional filtering (get-project-events)
• Sends a note to a specific device (send-note)
• Automatic token caching and refresh every 29 minutes

Use cases of Blues Notehub MCP Server (Python)

• List all Notehub projects under an account
• Fetch and filter devices belonging to a specific project
• Retrieve recent events from a project or device
• Send custom notes or commands to a device
• Integrate Notehub data into an LLM agent workflow

FAQ from Blues Notehub MCP Server (Python)

What are the prerequisites?

Python 3.8 or higher, a Blues Notehub account, and your Notehub username (email) and password.

How does authentication work?

The server uses the /auth/login endpoint to obtain an X-Session-Token, caching it for 29 minutes and automatically refreshing it when needed. Tokens expire after 30 minutes.

Where are logs stored if issues occur?

On macOS: ~/Library/Logs/Claude/mcp-server-notehub.log. On Windows: %APPDATA%\Claude\Logs\mcp-server-notehub.log.

What transport does the server use?

It runs using stdio as the transport layer, the standard transport for most MCP clients.

How do I use it with Claude for Desktop?

Edit the Claude Desktop configuration file (claude_desktop_config.json) to include a notehub entry pointing to the server script (e.g., python notehub.py). Restart Claude for Desktop.