Blues Notehub MCP Server (Python)

Name: Blues Notehub MCP Server (Python)
Author: blues

@blues

Repository

About Blues Notehub MCP Server (Python)

MCP Server Implementation of the Blues Notehub API

#notehub #mcp-server #python

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "notehub_mcp_server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Comments

More Other MCP servers

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K