Memos Self-Hosted Note Capture and Knowledge API
Enable AI agents to interact with Memos, an open-source self-hosted note-taking tool with REST and gRPC APIs. Agents can create, search, tag, and retrieve memos programmatically for knowledge management and quick capture workflows.
npx skills add agentskillexchange/skills --skill memos-self-hosted-note-capture-knowledge-api
Memos is an open-source, self-hosted note-taking tool built for instant capture. With over 58,000 GitHub stars and an MIT license, it has become one of the most popular lightweight knowledge management platforms. Its timeline-first UI and rich API surface make it an ideal backend for AI agent knowledge workflows.
What this skill actually does
What This Skill Enables
An agent skill built around Memos allows AI agents to serve as intelligent note-taking assistants. Through Memos’ REST API and gRPC API, agents can create new memos from conversations, meeting transcripts, or research sessions. They can search existing memos by content, tags, or date ranges, and retrieve context from previous captures to inform current tasks.
Core Capabilities
The Memos API provides full CRUD operations on memos, including creating memos with Markdown formatting, attaching resources (images, files), managing tags, and filtering by visibility (public, protected, private). Agents can use the search endpoint to perform full-text search across all memos, making it possible to build retrieval-augmented generation (RAG) pipelines backed by a user’s personal knowledge base. The API also supports memo pinning, archiving, and relation linking between memos.
Integration Points
Memos can be deployed as a single Go binary (~20MB Docker image) with SQLite, MySQL, or PostgreSQL backends. It exposes both REST (HTTP/JSON) and gRPC interfaces, giving agents flexibility in how they connect. The platform supports OAuth2 and access tokens for authentication. Agents can subscribe to memo creation events and build automated workflows that tag, categorize, or summarize new entries. The Markdown-native storage means memos are always portable and can be exported for use in other tools.
Technical Details
Memos is written in Go (backend) and React/TypeScript (frontend). The REST API is available at /api/v1/ with endpoints for memos, tags, resources, users, and system settings. Pagination is supported via page tokens. The gRPC API follows Protocol Buffers definitions available in the repository. Docker deployment requires a single command: docker run -d –name memos -p 5230:5230 -v ~/.memos:/var/opt/memos neosmemo/memos:stable.
Use Cases
AI agents can use this skill to capture meeting notes automatically, build searchable knowledge bases from chat conversations, maintain project decision logs, or create daily standup summaries. Combined with search capabilities, agents can answer questions like “what did we decide about the API design last week?” by querying the memo store directly.