For developers running Claude Code, Cursor & Codex

Track what you and your AI agents actually got done.

MCP-native Local-first Human + agent attribution

You run dozens of agent sessions a week, but what they finished lives in scroll-back and memory. Your own output across the day is barely better captured. There is no single record for either. Noatery is that record.

See features

Free to try · your work stays on your Mac · no subscription, ever.

Human capture
Shipped onboarding fix and confirmed with the customer.
Today, Thursday Apr 30
Shipped onboarding fix & confirmed with customer #support
You
Drafted Q3 retro and shared with the team #writing
You
Refactored auth middleware, all tests passing #code
Agent
MCP agent
Refactored auth middleware. 14 tests passing.
This week

Token usage shows what you spent.

Chat history shows what happened in one session.

Git shows what landed in the repo.

None of them give you a clean record of what actually got done, across human work and agent work alike.

How it works

One record.
Two ways to write to it.

Whether you log it yourself or an agent logs it through MCP, every entry lands in the same local SQLite database. One record. Clear attribution. Searchable and exportable any time.

You · Human capture

  • Quick Add hotkey: one window, one entry, out of the way
  • Backdate to yesterday or any date
  • Tags inline: #shipped #support
  • Search your full history any time

Agents · MCP write access

  • create_entry, search_entries, export_entries
  • Source tagged agent, separate from your entries
  • Same local DB, no separate API or sync
  • Filter human / agent / all when reviewing
Reading your record

One record.
Three ways out.

Writing is half the loop. A record only pays off when you can get it back out: to understand the week, to take it with you, or to hand the next agent the context it didn’t have. Same entries, read three ways, from the app or through MCP.

One local record
Shipped onboarding fix & confirmed with customer #support
You
Refactored auth middleware, 14 tests passing #code
Agent
Drafted Q3 retro & shared with the team #writing
You

Understand

Browse Today and Your Week, search full text, filter by tag or source. Agents read the same way to check what already shipped.

In the app list_entries search_entries

Take it with you

Export a date range or tag to Markdown or PDF from the app, or pull Markdown / JSON through MCP. Plain files, readable anywhere.

App · MD / PDF export_entries · MD / JSON
Your data · no lock-in

Feed the next task

Before the next session an agent can pull what already shipped, so it picks up with context instead of starting from zero.

search_entries list_entries
What your record gives you

Know what came out of the
time you and your agents spent.

Every capability in Noatery serves one goal: a durable, searchable record of completed work, so you always know what actually got done, and who did it.

Human + agent attribution

Every entry carries a source. See what agent work turned into finished output, not just what it consumed. Filter to human only, all, or agent only. MCP-native on Mac.

Tags & search

Drop #tags right into entries. Full-text search retrieves the thread later, across human and agent entries alike.

Markdown & PDF export

Save plain Markdown or a polished PDF by date range or tag. No proprietary format, no lock-in. Your record outlasts any client.

Quick capture

Global hotkey opens Quick Add from anywhere. One window, one entry, back to work. Log before it disappears.

Daily record

Day-level view of everything that landed, yours and your agents'. Backdate, edit, and refine without friction.

Week review

Activity timeline, top tags, and weekly totals. See the full picture of what moved, human work and agent work together.

• Local-first: entries live on your device ↗ Markdown & PDF export: readable anywhere ⌘ No account required ∞ Free to try, no subscription
Where Noatery lives

The one corner
no one else occupies.

Every work tool splits on two questions: how the work gets captured, and who owns the record. Three corners are crowded. The fourth — captured automatically by your agents and owned by you on your own device — is where Noatery lives, alone.

▲  Local-first · on your device · yours
Manual · yours Journals & note apps
— you type every line.
Automatic · yours Noatery the empty corner — alone.
Manual · cloud Standup bots & team logs
— on someone else’s server.
Automatic · cloud Time trackers & AI observability
— your work leaves your machine.
◀  You type it Your agents write it  ▶
The Mac app

One Mac app.
Everything you’ve shipped.

The Mac app is where you capture, review, search, export, and set up MCP — your whole record in one place, on your device. No account, no cloud, and it’s free to try.

macOS

The Mac app: capture, review, MCP

Quick Add, Today, Week, search, tags, and Markdown export, plus MCP server setup for agent logging. The full experience lives here.

Free to try on the Mac App Store
Today, Thursday · Apr 30
Shipped onboarding fix #support
Drafted Q3 retro & shared #writing
Refactored auth middleware #code
Mapped tomorrow’s standup #planning
Quick Add
Helped Maya unblock her PR
⌘ ↵  to log
MCP: protocol client

Agents write to
the same record.

The MCP server reads and writes the same local SQLite database your Mac app uses. No sync layer, no separate API, no auth required. Install once, add a config block to your AI client, and every agent session logs alongside your own entries.

Every entry carries a source. Filter to human only, all, or agent only whenever you need a clean view of who did what.

7 tools

create_entry list_entries search_entries update_entry delete_entry list_tags export_entries

Works with

Cursor Claude Code Claude Desktop Codex Windsurf VS Code Copilot

Install

npx @chainframe/noatery-mcp-server

Requires Noatery for Mac · Node.js ≥ 20 · macOS only

cursor · noatery-mcp
› tool: create_entry
  text: "Refactored auth middleware,
    all 14 tests passing"
  tags: ["#code", "#refactor"]
  source: agent

→ logged · entry_4f8a · today, 14:22

› tool: search_entries
  query: "#code" · last 7 days

→ 9 entries · 5 human · 4 agent
Connect your agents

From installed to logging,
in four steps.

In the Mac app, Settings → AI agents detects the clients you already run, writes the config, and drops a logging rule into each repo. Prefer to wire it by hand? The config is a few lines.

1

Connect a client

Noatery detects Claude Code, Cursor, Codex, Claude Desktop, and Windsurf, then writes the MCP config. On sandboxed builds it hands you the snippet to paste.

mcp config 
{
  "mcpServers": {
    "noatery": {
      "command": "npx",
      "args": ["-y", "--package", "@chainframe/noatery-mcp-server", "noatery-mcp-server"]
    }
  }
}

Codex uses the TOML equivalent · an optional DONELOG_DB_PATH pins a specific database.

2

Add a logging rule per repo

Noatery writes a short rule into each repo (CLAUDE.md, AGENTS.md, or a Cursor rule) so the agent knows when to log and what to skip. It previews the diff before writing.

CLAUDE.md appended 
## Logging completed work (Noatery MCP)

After a substantive task, call create_entry with a short, concrete summary.

Log:  shipped features, fixes, refactors, decisions with real output.
Skip: spikes, failing test runs, intermediate steps.

Include #agent #claude, a model tag (#opus_4_8), and #tags like #frontend.
3

Confirm with a test entry

Noatery writes one entry so you watch the whole pipeline land, agent to record, before any real work runs. Delete it after.

Noatery setup complete — agent logging is live #agent #noatery #setup
Agent
4

It logs itself from here

When an agent finishes a task it records what shipped, tagged to its source and model. Open Your Week on Friday to see what got done, yours and your agents’ together.

Available now

Software you own,
not software you rent.

Free on the Mac App Store. Your entries live on your Mac in plain, exportable SQLite — no account, no cloud, no subscription, ever.

macOS
7-day free trial
Noatery for Mac
Free to try, then yours to keep — no subscription.
  • Quick Add, Today, Week, tags & search
  • Insights & persona exports (standup, weekly, brag doc)
  • Human + agent attribution and filtering
  • Family Sharing — up to 5, no extra cost
  • Local data, no account required

MCP server included · free & open source

MCP server is included with Mac, free & open source. Learn more →

Requires macOS 13 or later · free to try · no account required

No subscription. No cloud. No account. Your work stays yours.

Questions

The practical stuff.

Is Noatery a to-do list? +
No. Noatery is for logging completed work, not planning unfinished work. The flip is intentional: instead of staring at what isn’t done yet, you build a clear record of what actually moved.
Do I need an account? +
No. The app works locally without an account. Open it, start logging.
Where is my data stored? +
Noatery is local-first. Entries live on your device by default, and export keeps your history portable. There’s no required Noatery cloud, and Settings lets you reveal the local data folder directly.
Can I export my data? +
Yes. Export to plain Markdown or PDF, by date range or tag. Markdown stays readable in any editor, and agents can pull Markdown or JSON through the MCP, so your record stays useful outside the app.
Does Noatery work with AI tools? +
Yes. The MCP server lets supported AI tools write to the same local record as you, with clear source attribution. Filter to human only, agent only, or all entries.
Is this a team tool? +
No. Noatery is personal software — a private record of your own work. It is not a shared workspace, team tool, or enterprise platform.
Is there a free trial? +
Yes — 7 days with everything unlocked. After that, unlock forever with a one-time purchase. Reading, searching, and exporting your entries always stay free.
What happens when the trial ends? +
New logging, Insights, and persona exports pause until you unlock. Everything you’ve already logged stays readable and exportable, free — nothing is ever held hostage.
What about subscriptions? +
There aren’t any. Noatery is a one-time unlock after a free trial. No monthly fee, no paid cloud add-on, no rented access to your own history.
I already bought Noatery — what now? +
You keep everything, free, forever. Existing owners are unlocked automatically — the trial and one-time unlock only apply to new installs.
Nitin Shukla Nitin Shukla
Why I'm building this
I've spent the last few years building AI tools for high-throughput workflows. The problem I kept hitting: agents do a lot, but the record of what they actually finished is scattered. None of that tells you what happened and what mattered in entirety. Noatery is the record I wanted for myself. LinkedIn ↗
Available now

One record.
Your work and your agents'.

Noatery for Mac is on the Mac App Store — free to try for 7 days. The MCP server is free and open source. Keep the record private, portable, and yours.