Skip to content

giuliohome-org/memos

Repository files navigation

Memos

Memos

An open-source, self-hosted note-taking service. Your thoughts, your data, your control — no tracking, no ads, no subscription fees.

Home Live Demo Docs Discord Docker Pulls

Memos Demo Screenshot

💎 Featured Sponsors

Warp — The AI-powered terminal built for speed and collaboration

Warp - The AI-powered terminal built for speed and collaboration

LambdaTest - Cross-browser testing cloud

LambdaTest - Cross-browser testing cloud

Overview

Memos is a privacy-first, self-hosted knowledge base that works seamlessly for personal notes, team wikis, and knowledge management. Built with Go and React, it offers lightning-fast performance without compromising on features or usability.

Why choose Memos over cloud services?

Feature Memos Cloud Services
Privacy ✅ Self-hosted, zero telemetry ❌ Your data on their servers
Cost ✅ Free forever, MIT license ❌ Subscription fees
Performance ✅ Instant load, no latency ⚠️ Depends on internet
Ownership ✅ Full control & export ❌ Vendor lock-in
API Access ✅ Full REST + gRPC APIs ⚠️ Limited or paid
Customization ✅ Open source, forkable ❌ Closed ecosystem

Features

  • 🔒 Privacy-First Architecture

    • Self-hosted on your infrastructure with zero telemetry
    • Complete data ownership and export capabilities
    • No tracking, no ads, no vendor lock-in
  • 📝 Markdown Native

    • Full markdown support
    • Plain text storage — take your data anywhere
  • ⚡ Blazing Fast

    • Built with Go backend and React frontend
    • Optimized for performance at any scale
  • 🐳 Simple Deployment

    • One-line Docker installation
    • Supports SQLite, MySQL, and PostgreSQL
  • 🔗 Developer-Friendly

    • Full REST and gRPC APIs
    • Easy integration with existing workflows
  • 🎨 Beautiful Interface

    • Clean, minimal design and dark mode support
    • Mobile-responsive layout

🤖 Claude AI integration (this fork)

This fork ships an MCP server in mcp-server/ that exposes your Memos instance to Anthropic's Claude — read, search, create, update, delete memos directly from a chat. Works across every Claude surface:

  • Claude Code CLI, Claude Desktop, claude.ai web, and the Claude Android / iOS app — all four surfaces go through the same OAuth 2.1 + PKCE flow against a GitHub OAuth App, no bearer header to copy around

A single long-running HTTP service per Memos instance serves all clients. Public exposure goes through your existing Cloudflare Tunnel; the gate is the OAuth flow plus the server-side OAUTH_ALLOWED_USERS allowlist of GitHub logins. See mcp-server/README.md for setup, including the section on public exposure for cloud Claude clients.

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

We welcome contributions of all kinds! Whether you're fixing bugs, adding features, improving documentation, or helping with translations — every contribution matters.

Ways to contribute:

Sponsors

Love Memos? Sponsor us on GitHub to help keep the project growing!

Star History

Star History Chart

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.


WebsiteDocumentationDemoDiscordX/Twitter

Vercel OSS Program

About

An open-source, self-hosted note-taking service. Your thoughts, your data, your control — no tracking, no ads, no subscription fees.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors