mcp -inbox

This MCP server connects to the inBox Notes API and exposes an MCP-compatible interface so any MCP-capable client can create notes in inBox through a conversational flow. The server supports optional note titles, and includes an Inspector UI for debugging and monitoring. To use, run the server via npx or run a local build and start the produced index.js file. Clients can send natural language prompts like “record a note about today’s study” or “create a note titled TypeScript study” and the server will forward the content to inBox via its API, returning success status and the resulting note details.

Prerequisites:

• Node.js 18+ (and npm)
• Access to inBox PRO API (token or URL-based configuration)

Option A: Run with npx (no local install)

1. Run the service directly with npx, supplying your inBox token: npx mcp-server-inbox --inbox_user_token=https://inbox.gudong.site/api/inbox/your_token_here

Option B: Local build and run

1. Clone the repository and install dependencies: git clone https://github.com/maoruibin/mcp-server-inbox.git cd mcp-server-inbox npm install

2. Build the project (if applicable): npm run build

3. Run the service using the built entry point: node build/index.js --inbox_user_token=https://inbox.gudong.site/api/inbox/your_token_here OR use the environment variable form: INBOX_USER_TOKEN=https://inbox.gudong.site/api/inbox/your_token_here node build/index.js

Tips:

• Ensure you have an active inBox PRO API token and the inBox API is reachable from your server.
• The API usage is limited per day (as per inBox API limits); be mindful of token usage.
• If using the Inspector, you can access status and debugging information at http://localhost:5173 after starting the Inspector task (npm run inspector).
• In MCP client configurations, you may specify the server similarly to Cursor AI, using the mcp-server-inbox entry with the appropriate token.
• The write_note API accepts title (optional) and content (required, Markdown supported, up to 3000 chars).