mcp-server-inbox
The MCP-Server-Inbox project is designed to integrate with the inBox Notes API, allowing users to create notes through MCP clients via conversational interaction. Key features include note creation, optional titles, and debugging tools. It requires inBox PRO and operates within given API limits.
MCP-Server-Inbox
MCP-Server-Inbox integrates with the inBox Notes API, enabling users to create notes using any MCP client in a conversational format.
Features
- Integration with inBox Notes API
- Provides MCP service discovery interface
- Supports note creation via MCP clients
- Optional note title configuration
- Includes Inspector debugging tool
Prerequisites
- Node.js 18+
- inBox Notes API (PRO feature)
- MCP protocol-supported client (e.g., Cursor AI)
Installation and Usage
Method 1: Using npx to run
- Run the service with your user token through npx.
Method 2: Local Build
- Clone the repository.
- Install dependencies.
- Build the project.
- Run the service.
Debugging and Development
Using Inspector
Run the built-in MCP Inspector tool to debug and monitor the service at http://localhost:5173.
Configuration in MCP Clients
Cursor AI
Edit the Cursor's MCP service configuration file to add MCP-Server-Inbox configuration.
Other MCP Clients
Refer to respective client configuration documentation to add similar configuration info.
API Description
write_note
- Writes note content to inBox with optional title and supports up to 3000 characters in Markdown.
inBox API
Relies on inBox API with endpoint: https://app.gudong.site/api/inbox/${userToken} for POST requests.
Limitations
- Maximum of 50 API requests per day
- Maximum note content of 3000 characters
- Requires inBox PRO
Contribution Guide
Submit issues or pull requests, ensuring that all code is TypeScript compiled, tested, and documented.
Changelog
v0.1.0
- Initial release with basic note creation, token configuration, and Inspector tool support.