What is Yonote Mcp

Yonote MCP is a Multi-Channel Platform server prototype designed for the Yonote service, which serves as an alternative to Notion. It provides API tools for interacting with Yonote documents and collections.

Use cases

Use cases for yonote-mcp include project management, collaborative document editing, and any scenario where users need to manage collections of documents and retrieve specific information programmatically.

How to use

To use yonote-mcp, clone the repository, install the required dependencies, configure environment variables, and run the MCP server using the command ‘python main.py’.

Key features

Key features include listing documents and collections from Yonote, retrieving detailed information about documents, and exposing tools via the FastMCP framework.

Where to use

Yonote MCP can be used in various fields that require document management and collaboration, particularly in environments where teams need to organize and access information efficiently.

Yonote MCP Server Prototype

This is an MVP project of an MCP 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

Installing via Smithery

To install Yonote Document Interaction Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @cutalion/yonote-mcp --client claude

Manual Installation

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:

python main.py

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:

{
  "mcpServers": {
    "yonote": {
      "command": "uv",
      "args": [
        "run",
        "-v",
        "--directory",
        "/path/to/yonote-mcp",
        "/path/to/yonote-mcp/main.py"
      ]
    }
  }
}

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