Yonote MCP Server
Used for loading environment variables to configure the MCP server with authentication credentials and API endpoints for the Yonote service.
Provides API tools to interact with Yonote documents and collections, which is described as an alternative to Notion. Allows listing documents/collections, retrieving document details, and navigating the content hierarchy.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Yonote MCP Server list my recent documents"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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: SiYuan MCP Server
Requirements
Python 3.13+
The following Python packages (see
pyproject.toml):fast-agent-mcp>=0.2.23requests>=2.32.3python-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 claudeManual Installation
Clone the repository:
git clone <your-repo-url> cd yonote-mcpInstall dependencies using uv:
uv pip install -r requirements.txt # or, using pyproject.toml: uv pip install .Configure environment variables:
Create a
.envfile 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.pyThe 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 IDcollections_list: Get a list of collections (with optional limit and offset)
Project Structure
main.py— Main server code and tool definitionspyproject.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.

Available Tools
3 toolscollections_listC
Get list of collections
Inputs: limit, offset.
documents_infoC
Get info about a document by id
Inputs: id (required).
documents_listC
Get list of documents
Inputs: limit, offset, collectionId.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: collections_list retrieves collections, documents_info gets details of a specific document, and documents_list lists documents. There is no overlap in functionality, making it easy for an agent to select the right tool without confusion.
All tool names follow a consistent verb_noun pattern with snake_case: collections_list, documents_info, and documents_list. The naming is predictable and readable throughout, with no deviations or mixed conventions.
With only 3 tools, the server feels thin for a note-taking domain, as it lacks essential operations like creating, updating, or deleting collections or documents. While the tools are well-scoped individually, the count is borderline low for covering basic CRUD workflows.
The tool surface is significantly incomplete for a note-taking server. It only provides read operations (list and get info) for collections and documents, with no ability to create, update, or delete resources. This will likely cause agent failures when trying to perform common tasks like adding or modifying notes.
Maintenance
Related MCP Connectors
Access and edit your Craft documents.
Share HTML/Markdown documents via URL instantly. Create, edit, delete docs from any AI tool.
Notes, kanban tasks, and a capture inbox: read and create Flow data with a personal token.
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Yuque (语雀) knowledge base platform through their API. Supports document management, search, and repository operations including creating, reading, updating, and deleting documents in multiple formats.928 npm3MIT
- AlicenseNot gradedqualityFmaintenanceEnables interaction with SiYuan Note through its API for comprehensive note management. Supports searching, creating, editing documents, managing notebooks, and daily notes operations through natural language commands.15Apache 2.0
- AlicenseCqualityBmaintenanceEnables interaction with note.com through API to search and read articles, manage posts and drafts, handle comments and likes, retrieve analytics, and access membership information.3436 npm31ISC
- AlicenseBqualityDmaintenanceEnables access to Yuque (语雀) documentation through cookie-based authentication, supporting document retrieval, search, TOC navigation, and content management from knowledge bases via URL or namespace.44MIT