Yonote MCP Server

Yonote MCP Server Prototype

This is an MVP project of an MCP (Multi-Channel Platform) server for the Yonote service, an alternative to Notion. The server provides API tools to interact with Yonote documents and collections.

Features

• List documents and collections from Yonote
• Get detailed information about a document
• Exposes tools via the FastMCP framework

Requirements

• Python 3.13+
• Yonote API credentials
• The following Python packages (see pyproject.toml):
  • fast-agent-mcp>=0.2.23
  • requests>=2.32.3
  • python-dotenv (for loading environment variables)
• uv for dependency management

Setup

1. Clone the repository:
   git clone <your-repo-url> cd yonote-mcp
2. Install dependencies using uv:
   uv pip install -r requirements.txt # or, using pyproject.toml: uv pip install .
3. Configure environment variables:Create a .env file in the project root with the following content:
   API_TOKEN=your_yonote_api_token API_BASE_URL=https://app.yonote.ru/api # Optional, defaults to this value

Usage

Run the MCP server:

The server exposes the following tools:

• documents_list: Get a list of documents (with optional limit, offset, and collectionId)
• documents_info: Get info about a document by ID
• collections_list: Get a list of collections (with optional limit and offset)

Project Structure

• main.py — Main server code and tool definitions
• pyproject.toml — Project metadata and dependencies

License

MIT (or specify your license)

Cursor Configuration Example

To use this MCP server with Cursor, add the following to your ~/.cursor/mcp.json configuration file:

Replace /path/to/yonote-mcp with the actual path to your project directory.