Skip to main content
Glama

Yonote MCP Server

by cutalion

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.

Screenshot

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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.

  1. Features
    1. Requirements
      1. Setup
        1. Installing via Smithery
        2. Manual Installation
      2. Usage
        1. Project Structure
          1. License
            1. Cursor Configuration Example

              Related MCP Servers

              • -
                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 -
                12
                16
                TypeScript
              • -
                security
                A
                license
                -
                quality
                Enables advanced todo list management and content organization using Notion's API, supporting features like creating databases, dynamic filtering, and collaborative task tracking.
                Last updated -
                27
                Python
                MIT License
              • -
                security
                F
                license
                -
                quality
                Facilitates note storage and summarization through custom URIs, allowing users to manage, summarize, and update notes with varying detail levels in a collaborative environment.
                Last updated -
                Python
                • Apple
              • -
                security
                F
                license
                -
                quality
                Enables interaction with Notion through the Notion API by exposing it as tools for LLMs, allowing operations like reading, creating, updating, and deleting Notion pages seamlessly via natural language.
                Last updated -
                11
                21
                TypeScript

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/cutalion/yonote-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server