mcp -memos

This MCP server provides a bridge to the Memos note-taking service. It exposes a set of tools that let clients search, create, fetch, and update Memos notes using natural language queries. The server handles authentication via a MEMOS_TOKEN and connects to your Memos instance using MEMOS_URL. Available tools include search_memo for finding notes by keywords, create_memo for adding new notes with configurable visibility, get_memo to retrieve a specific note by its ID, and update_memo to modify the content of an existing note. To use the server, configure the MEMOS_URL and MEMOS_TOKEN (either through environment variables or command-line arguments), then run the server via npm or by using the hosted MCP.so option. Once running, clients can issue requests in MCP-compatible formats to perform all supported operations against your Memos instance.

Prerequisites:

• Node.js and npm installed on your system
• Access token for the target Memos server

Installation steps:

1. Clone the repository:

git clone https://github.com/your-username/mcp-server-memos.git
cd mcp-server-memos

2. Install dependencies:

npm install

3. Create a configuration file or environment variables: Option A (env):

MEMOS_URL=https://your-memos-server
MEMOS_TOKEN=your_access_token

Option B (env in a .env file):

MEMOS_URL=https://your-memos-server
MEMOS_TOKEN=your_access_token

4. Run the server locally:

npm run inspector

5. (Optional) If using Cursor, add the mcp.json entry as shown in the README to enable the MCP integration.

Tips and considerations:

• Keep MEMOS_TOKEN secure; prefer environment variables over command-line arguments in production.
• If you deploy on MCP.so, you can avoid local setup by providing MEMOS_URL and MEMOS_TOKEN in the hosted configuration.
• Ensure the Memos server is reachable from the MCP environment (network access and correct URL).
• The server supports search, create (with visibility options PUBLIC/PROTECTED/PRIVATE), get by ID, and update operations. For updates, provide the target memos/{id} as the note identifier.
• When using Cursor, you can configure the MCP server under ~/.cursor/mcp.json with the provided command and environment variables.
• Regularly rotate MEMOS_TOKEN and keep access permissions minimal to reduce risk of credential leakage.