The Yonote MCP server acts as a bridge between AI assistants and the Yonote workspace, a collaborative platform often used as an alternative to Notion. This tool allows an AI model to navigate through a user’s organized notes and folders, making it possible for the assistant to find, read, and summarize documents on demand. By connecting these two systems, users can turn their personal or team documentation into a searchable knowledge base that an AI can interact with directly. Moving into more specific capabilities, the server provides three primary tools: `documents_list`, `documents_info`, and `collections_list`. These functions enable an LLM to programmatically browse through various document collections, filter results with limits and offsets, and retrieve the full content of specific files using their unique IDs. This structured access allows an AI to handle complex tasks, such as cross-referencing information between different documents or keeping track of project updates stored within the Yonote ecosystem. For developers and power users, this MCP server is built on the FastMCP framework and requires Python 3.13 or higher. It is designed for easy deployment, supporting both manual installation via the `uv` package manager and automated setup through Smithery. Because it adheres to the Model Context Protocol, the server can be integrated into environments like Claude Desktop or Cursor, providing AI agents with the necessary permissions and API tools to securely fetch real-time data from the Yonote API. This makes it an essential utility for anyone looking to build a more context-aware AI workflow using their existing documentation.
Category: Files, Documents & PDFs
Tags: collaboration, documentation, knowledge-base, yonote
bash npx -y @smithery/cli install @cutalion/yonote-mcp --client claude Manual Installation 1. Clone the repository: bash git clone <your-repo-url> cd yonote-mcp 2. Install dependencies: Using uv: bash uv pip install -r requirements.txt # or uv pip install . 3. Configure Environment Variables: Create a .env file in the project root: env API_TOKEN=your_yonote_api_token API_BASE_URL=https://app.yonote.ru/api # Optional ---~/.cursor/mcp.json file (replace /path/to/yonote-mcp with your actual local path): json { "mcpServers": { "yonote": { "command": "uv", "args": [ "run", "-v", "--directory", "/path/to/yonote-mcp", "/path/to/yonote-mcp/main.py" ] } } } ---documents_list: Get a list of documents. * Parameters: limit (optional), offset (optional), collectionId (optional). * documents_info: Get detailed information about a specific document. * Parameters: id (required). * collections_list: Get a list of collections. * Parameters: limit (optional), offset (optional). ---collections_list to find the "Engineering" folder, identifies the "Security-v2" document via documents_list, reads the content using documents_info, and then writes the code following those exact specifications.documents_list and…Part of MCP Servers
Yonote is an MCP server that acts as a connector between AI models and the Yonote workspace. It exposes tools allowing clients like Claude Desktop and Cursor to read collections and document contents from your workspace.
The server exposes three primary tools: documents_list to retrieve documents with optional limit, offset, and collectionId parameters; documents_info to fetch detailed document data by ID; and collections_list to browse available collections.
The server requires Python 3.13 or higher, the uv package manager, and valid Yonote API credentials. It depends on packages such as fast-agent-mcp, requests, and python-dotenv.
It works with MCP-compatible clients including Claude Desktop and Cursor. Installation can be handled automatically using the Smithery CLI or configured manually through client settings files.
Yes, Yonote is open source software provided under an open-source license and hosted publicly on GitHub.