Blues Notehub MCP Server (Python)

@blues

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

blues

关于 Blues Notehub MCP Server

MCP Server Implementation of the Blues Notehub API

#notehub#mcp-server #python

Blues Notehub MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Blues Notehub MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

常见问题

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.

其他分类下的更多 MCP 服务器

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

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Codelf

unbug

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

14.2K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

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