# Flomo

> Read and write flomo memos on macOS. Use when user asks to fetch recent flomo notes, search memo text in local flomo cache, or create/write a new memo to flomo via incoming webhook or URL scheme.

- Skill: `modbender/flomo` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add modbender/flomo`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/flomo/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/flomo

---


# flomo

Use this skill on macOS to read and write flomo content.

## Commands

- Read recent memos (remote API, recommended; auto-expands time window):

```bash
python3 scripts/flomo_tool.py read --remote --limit 20
```

- Search recent memos by keyword (remote API):

```bash
python3 scripts/flomo_tool.py read --remote --limit 100 --query "关键词"
```

- Read by tag (recommended for diary/book/etc):

```bash
python3 scripts/flomo_tool.py read --remote --limit 10 --tag "日记"
```

- List top tags (to see how many memos each tag has):

```bash
python3 scripts/flomo_tool.py read --dump-tags --limit 20
```

- Write memo (auto-resolve incoming webhook from local flomo login state):

```bash
python3 scripts/flomo_tool.py write --content "内容"
```

- Write memo via URL scheme (opens flomo app draft):

```bash
python3 scripts/flomo_tool.py write --content "内容" --url-scheme
```

- One-shot health check (read + write-url-scheme dry flow):

```bash
python3 scripts/flomo_tool.py verify --try-webhook --query "#openclaw"
```

## Behavior Rules

- Prefer webhook write; script can auto-resolve webhook when logged in on this Mac.
- Use URL scheme write only as fallback, because it requires GUI interaction to confirm/save.
- Read path uses remote API first and can auto-expand search window for sparse tags/keywords.
- For tag intent, prefer `--tag`; `--query "#标签"` is also supported.
- Never print full webhook URL in logs; only print masked form.