For AI-native builders · Now on the Mac App Store

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.

Human capture
Shipped onboarding fix and confirmed with the customer.
Today, Thursday
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 ledger.
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 the ledger

One ledger.
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 ledger
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 the ledger 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 Buy once, no subscription
The Mac app

One Mac app.
The whole ledger.

The Mac app is where you capture, review, search, export, and set up MCP, the full ledger in one place. A one-time purchase, no subscription.

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 ledger experience lives here.

One-time purchase · $49.99 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 ledger.

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 ledger, 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

Buy once. Own
the local-first work ledger.

On the Mac App Store now. A one-time purchase, local data, no subscription.

macOS
Launch price
Noatery for Mac
$49.99
One-time purchase
  • Quick Add & global hotkey
  • Today, Week, tags, search, export
  • Human + agent attribution and filtering
  • Local data, no account required

MCP server included · free & open source

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

Requires macOS 12 or later · one-time purchase

No subscription. No cloud add-on. Apps you buy once and keep.

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 ledger 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 work ledger for your own record. It is not a shared workspace, team tool, or enterprise platform.
What about subscriptions? +
There aren’t any. Each app is a one-time purchase. No monthly fee, no paid cloud add-on, no rented access to your own history.
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 ledger I wanted for myself. LinkedIn ↗
Available now

One ledger.
Your work and your agents'.

Noatery for Mac is on the Mac App Store, with the MCP server free and open source. Keep the record private, portable, and yours.