47d9414702
Embeds a Model Context Protocol (MCP) server into the Memos HTTP process, exposing memo operations as MCP tools at POST/GET /mcp using Streamable HTTP transport. Authentication is PAT-only — requests without a valid personal access token receive HTTP 401. Six tools are exposed: list_memos, get_memo, create_memo, update_memo, delete_memo, and search_memos, all scoped to the authenticated user. |
3 months ago | |
|---|---|---|
| .github | 4 months ago | |
| cmd/memos | 4 months ago | |
| internal | 3 months ago | |
| plugin | 3 months ago | |
| proto | 4 months ago | |
| scripts | 4 months ago | |
| server | 3 months ago | |
| store | 3 months ago | |
| web | 3 months ago | |
| .dockerignore | 5 months ago | |
| .gitignore | 5 months ago | |
| .golangci.yaml | 5 months ago | |
| AGENTS.md | 4 months ago | |
| CODEOWNERS | 3 months ago | |
| LICENSE | 1 year ago | |
| README.md | 4 months ago | |
| SECURITY.md | 4 months ago | |
| go.mod | 3 months ago | |
| go.sum | 3 months ago | |
README.md
Memos
An open-source, self-hosted note-taking service. Your thoughts, your data, your control — no tracking, no ads, no subscription fees.
💎 Featured Sponsors
Warp — The AI-powered terminal built for speed and collaboration
TestMu AI - The world’s first full-stack Agentic AI Quality Engineering platform
SSD Nodes - Affordable VPS hosting for self-hosters
Overview
Memos is a privacy-first, self-hosted knowledge base for personal notes, team wikis, and knowledge management. Built with Go and React, it runs as a single binary with minimal resource usage.
Features
- Privacy-First — Self-hosted on your infrastructure with zero telemetry, no tracking, and no ads.
- Markdown Native — Full markdown support with plain text storage. Your data is always portable.
- Lightweight — Single Go binary with a React frontend. Low memory footprint, starts in seconds.
- Easy to Deploy — One-line Docker install. Supports SQLite, MySQL, and PostgreSQL.
- Developer-Friendly — Full REST and gRPC APIs for integration with existing workflows.
- Clean Interface — Minimal design with dark mode and mobile-responsive layout.
Quick Start
Docker (Recommended)
docker run -d \
--name memos \
-p 5230:5230 \
-v ~/.memos:/var/opt/memos \
neosmemo/memos:stable
Open http://localhost:5230 and start writing!
Try the Live Demo
Don't want to install yet? Try our live demo first!
Other Installation Methods
- Docker Compose - Recommended for production deployments
- Pre-built Binaries - Available for Linux, macOS, and Windows
- Kubernetes - Helm charts and manifests available
- Build from Source - For development and customization
See our installation guide for detailed instructions.
Contributing
Contributions are welcome — bug reports, feature suggestions, pull requests, documentation, and translations.
Sponsors
Love Memos? Sponsor us on GitHub to help keep the project growing!
Star History
License
Memos is open-source software licensed under the MIT License.
Privacy Policy
Memos is built with privacy as a core principle. As a self-hosted application, all your data stays on your infrastructure. There is no telemetry, no tracking, and no data collection. See our Privacy Policy for details.
Website • Documentation • Demo • Discord • X/Twitter
