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

Related MCP server: mcp-discord-chat MCP server

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:

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:

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.