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.
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:
Manual Installation
- Clone the repository:
- Install dependencies using uv:
- Configure environment variables:Create a
.env
file in the project root with the following content:
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 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:
Replace /path/to/yonote-mcp
with the actual path to your project directory.
This server cannot be installed
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.
Related MCP Servers
- -securityFlicense-qualityEnables AI language models to interact with Microsoft OneNote via a standardized interface, supporting notebook and page management through natural language.Last updated -1216TypeScript
- -securityAlicense-qualityEnables advanced todo list management and content organization using Notion's API, supporting features like creating databases, dynamic filtering, and collaborative task tracking.Last updated -27PythonMIT License
- -securityFlicense-qualityFacilitates 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
- -securityFlicense-qualityEnables 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 -1121TypeScript