Yonote MCP Server

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

Clone the repository:
git clone <your-repo-url> cd yonote-mcp
Install dependencies using uv:
uv pip install -r requirements.txt # or, using pyproject.toml: uv pip install .
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.

Screenshot

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

Provides API tools to interact with Yonote documents and collections, serving as an alternative to Notion with capabilities to list documents/collections and retrieve detailed document information.

Related MCP Servers

OneNote MCP Server
ZubeidHendricks
-
security
F
license
-
quality
Enables AI language models to interact with Microsoft OneNote via a standardized interface, supporting notebook and page management through natural language.
Last updated -
107
6
TypeScript
MCP Ollama Link
truaxki
-
security
F
license
-
quality
Facilitates initiating Ollama queries via Claude and manages a simple note storage system with capabilities to add, summarize, and access notes using custom URIs.
Last updated -
1
2
Python
Curri MCP Server
teamcurri
-
security
F
license
-
quality
Enables interaction with Curri's API by managing text notes, offering tools for note creation, and generating summaries using structured prompts.
Last updated -
JavaScript
Apple Notes MCP Server
Siddhant-K-code
A
security
A
license
A
quality
Enables interaction with Apple Notes via natural language, supporting note creation, search, and retrieval with iCloud integration for seamless note management.
Last updated -
3
2
TypeScript
MIT License

View all related MCP servers

Yonote MCP Server