The hardest problem in note-taking is not organization. It is the three seconds between having a thought and having somewhere to put it. Lose those three seconds often enough and you stop writing things down at all.
Notez attacks that from six directions.
1. The CLI
If you live in a terminal, this is the fastest path that exists.
notez "postgres connection pool exhausted under load — check pgbouncer config"That is the whole interaction. The note is in your workspace before your hands leave the keyboard.
Pass a file path instead and it uploads the file:
notez ./architecture-diagram.pngThe full surface is deliberately tiny:
Command | What it does |
|---|---|
| Capture text as a note |
| Upload a file |
| Authorize this terminal |
| Forget the stored CLI key |
| Install the latest version |
Two flags: --title to set the title, and --json to print the created note as JSON — handy for piping into other tools. You can pipe input in too, so git log --oneline -10 | notez --title "Release commits" works.
The CLI is capture-only. There is no list, search, edit, or delete. That is intentional: it is a small native binary whose one job is to never make you wait. Install it on macOS or Linux (on Windows, run iwr -useb https://notez.dev/install.ps1 | iex in PowerShell):
curl -fsSL https://notez.dev/install.sh | shThen run notez login once per machine.
2. MCP — let your AI assistant write to your notes
Notez runs a Model Context Protocol server, which means Claude Code, Claude Desktop, Cursor, and Windsurf can talk to your workspace directly.
Claude, Claude Code, ChatGPT and VS Code connect by signing in to Notez. For Cursor, Windsurf or a script, the workspace owner generates a key in Settings → Integrations → Notez MCP server, and the page hands you a ready-to-paste command with your endpoint and token filled in.
With a key, your assistant gets 31 tools: it reads, searches, creates, edits, renames, moves, tags, deletes (to the Bin) and restores notes, and uploads files. Signing in with Read and write gives it 32, adding list_workspaces; Read only gives 14.
The practical effect is that you can end a debugging session with "write up what we just figured out as a note tagged postgres" and it is done — instead of the conclusion evaporating when you close the tab.
Two things worth knowing. Each MCP key is bound to a single workspace, so a key scoped to your work workspace cannot see your personal notes. And a connection made by signing in reaches every workspace you belong to.
3. Type-anywhere capture
Open the web app, click nothing, and just start typing. Letters go straight into search — because most of the time you are looking for something you already wrote.
But if it turns out you are not, press ↵. The suggestion list highlights Create note "..." by default, so Enter saves what you typed as a new note — the search already ran while you typed, and the status line above the suggestions shows what it found. ⌘↵ does the same without the suggestions. Every capture shows a toast with Undo and Open.
This works on every app page except the note detail view and the CLI auth screen, where typing obviously means something else.
4. Clipboard capture
⌘V with nothing focused saves your clipboard as a note on the spot — no dialog. Text becomes a note, a bare URL a bookmark, and files or images become a note with the files attached. Copy a screenshot from anywhere, hit ⌘V, done; Undo is one click away on the toast.
You can also paste images directly into the editor while writing and they upload in place, compressed automatically.
5. URL capture
Paste a bare URL as a quick note and Notez recognizes it, saving it as a bookmark note with the URL stored rather than as a wall of text. Read-it-later without a second app.
Worth setting expectations: nothing is fetched from the page. No preview, no favicon, no title lookup — just a clean, private record of the link. And the URL needs its https:// prefix to be recognized as one.
6. Quick capture in the app
⌘E opens a new note from anywhere. ⌘↵ saves it.
On a board, quick-add cards let you type straight into a column — ↵ saves, ⇧↵ adds a new line, Esc cancels.
Where did this note come from?
Because there are so many entry points, Notez badges notes that arrived from somewhere other than the app itself: the CLI, MCP, the API, AI chat, a webhook, a URL capture, or an import. Telegram capture is gone, but the notes saved through it keep their Telegram badge.
It is a small thing that turns out to be genuinely useful. You learn that your best ideas arrive through the CLI at 11pm, or that everything captured from MCP needs a cleanup pass. Capture friction is invisible until you can see it.
The point
None of these are impressive features on their own. Together they mean the answer to "where do I put this?" is always the same: wherever you already are. Organizing can happen later — with tags, nesting, boards, and properties — and finding it later is what AI chat and hybrid search are for.
The only step that has to be frictionless is the first one.
Continue reading
7 Ways to Capture Ideas Without Losing Focus — the URL bar, the terminal, an assistant, voice memos and code comments, ordered by how little each one asks of you mid-task.
Capture, faster: Enter creates, paste saves — why Enter in the search box creates a note, why ⌘V saves without a dialog, and the Undo that comes with every capture.
Getting Started With the Notez CLI — the install commands for macOS, Linux and Windows, where
notez loginkeeps its key, and scripting with--json.