memos

# Memos ## What it does Provides full CRUD operations on a self-hosted Memos instance through 5 MCP tools. Agents can create quick notes, search existing memos, update content or visibility, and delete memos they no longer need. ## Inputs needed - For creating: content (required), visibility (optional, defaults to PRIVATE) - For listing: filter expression (optional), page size (optional) - For get/update/delete: memo ID (required) ## Prerequisites ### `openclaw-memos-mcp` MCP server This skill requires the `openclaw-memos-mcp` MCP server to be running. Before using any `memos_*` tool, check if the tools are available. If not, tell the user they need to add the MCP server to their configuration: ```json { "mcpServers": { "memos": { "command": "npx", "args": ["openclaw-memos-mcp"], "env": { "MEMOS_API_URL": "http://localhost:5230", "MEMOS_TOKEN": "<your-access-token>" } } } } ``` Tell the user to: 1. Replace `MEMOS_API_URL` with their Memos instance URL 2. Get an access token from Memos: **Settings > Access Tokens > Create** 3. Replace `<your-access-token>` with the token 4. Restart their MCP client after saving the configuration ## Workflow ### Creating a memo Call `memos_create` with the content and optional visibility. - `content`: Markdown text. Supports `#hashtags` which Memos auto-extracts as tags. - `visibility`: `PRIVATE` (default), `PROTECTED` (logged-in users), or `PUBLIC` (everyone). ### Listing memos Call `memos_list` to browse or search memos. - `pageSize`: Number of results (default 20). - `pageToken`: For pagination, use the `nextPageToken` from a previous response. - `filter`: CEL filter expression. Examples: - `tag == "work"` — memos tagged #work - `visibility == "PUBLIC"` — public memos only - `creator == "users/1"` — memos by a specific user ### Reading a specific memo Call `memos_get` with the memo ID. The ID is the part after `memos/` in the resource name (e.g., if the name is `memos/abc123`, the ID is `abc123`). ### Updating a memo Call `memos_update` with the memo ID and the fields to change. Only specify fields you want to update — unspecified fields remain unchanged. - `content`: New Markdown content - `visibility`: New visibility level - `pinned`: `true` to pin, `false` to unpin ### Deleting a memo Call `memos_delete` with the memo ID. **This is irreversible.** Always confirm with the user before deleting. ## Guardrails - Default visibility to `PRIVATE` — never create public memos unless explicitly asked - Validate content is non-empty before creating - Confirm with the user before deleting any memo - On 401/403 errors, tell the user to check their `MEMOS_TOKEN` - On connection errors, tell the user to check their `MEMOS_API_URL` - When listing returns empty results, suggest the user check their filter or confirm the Memos instance has data