MCPcopy
hub / github.com/usememos/memos

github.com/usememos/memos @v0.29.1 sqlite

repository ↗ · DeepWiki ↗ · release v0.29.1 ↗
6,364 symbols 18,695 edges 697 files 1,425 documented · 22%
README

Featured Sponsors

Warp Warp is an agentic development environment. CodeRabbit Cut code review time & bugs in half, instantly.

Memos

Memos

Open-source, self-hosted note-taking tool built for quick capture. Markdown-native, lightweight, and fully yours.

Home Live Demo Docs Discord Docker Pulls

Memos Demo Screenshot

Features

  • Instant Capture — Timeline-first UI. Open, write, done — no folders to navigate.
  • Total Data Ownership — Self-hosted on your infrastructure. Notes stored in Markdown, always portable. Zero telemetry.
  • Radical Simplicity — Single Go binary, ~20MB Docker image. One command to deploy with SQLite, MySQL, or PostgreSQL.
  • Open & Extensible — MIT-licensed with full REST and gRPC APIs for integration.

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!

Native Binary

curl -fsSL https://raw.githubusercontent.com/usememos/memos/main/scripts/install.sh | sh

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

Star History Chart

License

Memos is open-source software licensed under the MIT License. See our Privacy Policy for details on data handling.

Website • Documentation • Demo • Discord • X/Twitter

Vercel OSS Program

Extension points exported contracts — how you extend this code

MemoServiceClient (Interface)
MemoServiceClient is a client for the memos.api.v1.MemoService service. [6 implementers]
proto/gen/api/v1/apiv1connect/memo_service.connect.go
Transcriber (Interface)
Transcriber transcribes audio to text using a provider's dedicated STT endpoint. [7 implementers]
internal/ai/stt/stt.go
Condition (Interface)
Condition represents a boolean expression derived from the CEL filter. [9 implementers]
internal/filter/ir.go
Job (Interface)
Job is an interface for submitted cron jobs. [5 implementers]
internal/cron/cron.go
Driver (Interface)
Driver is an interface for store driver. It contains all methods that store database driver should implement. [3 implementers]
store/driver.go
Logger (Interface)
Logger is a minimal logging interface. [3 implementers]
internal/scheduler/middleware.go
Interface (Interface)
Interface defines the operations a cache must support. [1 implementers]
store/cache/cache.go
Service (Interface)
Service handles markdown metadata extraction. It uses goldmark to parse markdown and extract tags, properties, and snipp [1 …
internal/markdown/markdown.go

Core symbols most depended-on inside this repo

Error
called by 513
internal/cron/logger.go
Run
called by 332
internal/cron/cron.go
Len
called by 267
internal/version/version.go
Cleanup
called by 226
server/router/api/v1/test/test_helper.go
NewTestService
called by 214
server/router/api/v1/test/test_helper.go
cn
called by 212
web/src/lib/utils.ts
Close
called by 186
store/cache/cache.go
CreateUserContext
called by 186
server/router/api/v1/test/test_helper.go

Shape

Method 3,094
Function 2,409
Struct 454
Interface 323
TypeAlias 43
Enum 20
FuncType 11
Class 10

Languages

Go80%
TypeScript20%

Modules by API surface

proto/gen/api/v1/user_service.pb.go450 symbols
proto/gen/api/v1/memo_service.pb.go326 symbols
proto/gen/api/v1/instance_service.pb.go253 symbols
proto/gen/store/instance_setting.pb.go185 symbols
proto/gen/api/v1/user_service_grpc.pb.go136 symbols
proto/gen/store/user_setting.pb.go126 symbols
proto/gen/api/v1/memo_service_grpc.pb.go111 symbols
proto/gen/api/v1/apiv1connect/user_service.connect.go106 symbols
proto/gen/api/v1/idp_service.pb.go100 symbols
proto/gen/api/v1/attachment_service.pb.go100 symbols
proto/gen/api/v1/apiv1connect/memo_service.connect.go86 symbols
proto/gen/api/v1/auth_service.pb.go79 symbols

Dependencies from manifests, versioned

cel.dev/exprv0.25.1 · 1×
cloud.google.com/gov0.123.0 · 1×
cloud.google.com/go/authv0.20.0 · 1×
cloud.google.com/go/compute/metadatav0.9.0 · 1×
connectrpc.com/connectv1.19.2 · 1×
dario.cat/mergov1.0.2 · 1×
filippo.io/edwards25519v1.2.0 · 1×
github.com/Azure/go-ansitermv0.0.0-2025010203350 · 1×
github.com/Microsoft/go-winiov0.6.2 · 1×
github.com/antlr4-go/antlr/v4v4.13.1 · 1×
github.com/at-wat/ebml-gov0.18.0 · 1×
github.com/aws/aws-sdk-go-v2v1.41.6 · 1×

Datastores touched

memos_testDatabase · 1 repos

For agents

$ claude mcp add memos \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact