Advertise
MCP.so
Sign In

Blues Notehub MCP Server (Python)

@blues

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

blues

About Blues Notehub MCP Server

MCP Server Implementation of the Blues Notehub API

#notehub#mcp-server#python

Blues Notehub MCP Server config

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

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

Blues Notehub MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

What are the prerequisites?

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

2

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.

3

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`.

4

What transport does the server use?

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

5

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

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K
Advertise