Dear Agent

io.github.BitmapAssetPublished by GitHub account BitmapAssetv0.2.3Updated Oct 24, 2026

Your AI agent keeps your diary for you. Local-first, private, works in any agent.

VerifiedSTDIODesktop onlyProductivity & WorkflowFiles & StorageKnowledge & Memory

Overview

AI-generated overview

Lets an AI assistant keep a local markdown diary, saving text, photos and voice notes by date and recalling past entries.

What you can do
Dear Agent gives an assistant tools to write and read a personal journal stored as plain markdown on the user's own disk. Tools include add_entry, add_photo and add_voice_note for filing moments by date, plus get_day, get_range, search, list_days and on_this_day for reading them back. recall synthesizes what the diary knows about a person or topic, and reflect and weekly_digest surface patterns, open loops and past-date memories. It also exposes MCP prompts, resources and a CLI.
When to use it
Worth adding when someone wants a private, local journal that their agent maintains from ordinary conversation instead of a separate app. Useful for daily logging, photo and voice capture, and asking what happened on a given day or a year ago.
Requirements
Runs locally over stdio, typically via npx or a global npm install, so Node.js is needed. The optional DEAR_AGENT_DIR environment variable sets where the diary is stored, defaulting to ~/.dear-agent. No account, API key or network access is declared.
Before you install
The diary is personal and sensitive: entries, photos and voice notes are written to disk under DEAR_AGENT_DIR, and recall or reflect may surface that content into the agent conversation. It writes files rather than deleting them, but anything the assistant records is stored in plain markdown, so consider where that folder lives and who can read it.

Installation

In SourceWeft

  1. Open Dear Agent in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Dear Agent

[npm version] [license: MIT] [MCP] [PRs welcome]

[A person tells their AI agent about a hard day; the agent writes it into their diary.]

Your AI agent keeps your diary for you. You never open an app or write a word.

You already talk to an AI agent all day. Dear Agent lets that agent quietly keep your personal life journal — filing what you tell it, the photos you send, and the voice notes you record, neatly by date. No app to open. No blank page to face. No habit to build. You just live your life and mention what matters; your agent does the writing.

It is a single, local-first MCP server plus a skill, so it drops into any agent that speaks MCP: Claude Code, Claude Desktop, Cursor, OpenClaw, and more.

Why it is different

  • You do not write it. Your agent does. Every other journal — Day One, Obsidian, Notion, a paper notebook — needs you to open it and type. Dear Agent flips that: you talk, it records.
  • Cross-agent. One diary, readable and writable by whatever agent you use.
  • Text, photos, and voice. Send a picture or a voice note and it is filed under that day.
  • Local-first and yours. Plain markdown on your own disk. No account, no cloud, no lock-in. Delete the folder and it is gone.
  • It remembers with you. "On this day" resurfaces past entries; a weekly digest lets your agent write you a short reflection.

Install

bash
npm install -g dear-agent

Or run it straight from npx (no install):

bash
npx dear-agent

Claude Code / Claude Desktop

bash
claude mcp add dear-agent -- npx -y dear-agent

Or add to your MCP config:

json
{  "mcpServers": {    "dear-agent": {      "command": "npx",      "args": ["-y", "dear-agent"]    }  }}

Cursor / OpenClaw / other MCP clients

Point the client at the dear-agent command (stdio transport). Set DEAR_AGENT_DIR if you want the diary somewhere other than ~/.dear-agent.

Then drop SKILL.md into your agent's skills so it knows to keep your diary proactively.

How you use it

You never call tools yourself. You just talk to your agent:

"Remember that I closed the apartment lease today, felt huge relief." "Save this photo for today — first dinner in the new place." (send the photo) "What was I doing a year ago today?" "Give me a recap of this week."

Your agent calls the right tool and keeps the diary current.

It remembers you, and it talks back

Dear Agent is not just storage. Two capabilities turn it into a living memory of your life:

  • recall — your agent can ask the diary "what do you know about this person — their people, patterns, open commitments?" and get a synthesized portrait. Your agent finally remembers your life, so every conversation is grounded in who you actually are.
  • reflect — a proactive loop that surfaces patterns, progress, open loops, and on this day memories, so your diary reflects your life back to you instead of sitting in a folder.

Obsidian stores your notes. Dear Agent remembers your life and talks back. And because it never leaves your machine, it's the one place you can be completely honest.

Works with any agent, harness, or interface

InterfaceHow
MCP tools11 tools (below) over stdio.
MCP promptsdaily_checkin, weekly_reflection — surface as slash-commands.
MCP resourcesdiary://today, diary://index.
SkillSKILL.md for skill-based harnesses (Claude Code, OpenClaw).
CLIdear-agent add "...", recall, reflect, … — for any agent that can run a shell.

CLI examples:

bash
dear-agent add "Closed the interview, felt good." --mood hopeful --tags job,windear-agent recall Sarahdear-agent reflect weekdear-agent on-this-day

Tools

ToolWhat it does
add_entrySave a text moment (optional mood, tags) for a day.
add_photoSave a photo for a day (local path or base64), with a caption.
add_voice_noteSave a voice note for a day, with an optional transcript.
get_dayRead one day's full entry.
get_rangeRead entries between two dates.
searchFind days matching a word or phrase.
recallWhat the diary knows about a person/topic, or a whole-life profile digest.
reflectPatterns, progress, open loops, and on-this-day, for a proactive check-in.
on_this_dayResurface this same calendar date from past years.
weekly_digestPull the last 7 days for a reflection.
list_daysList every day on record.

Dates accept today, yesterday, or YYYY-MM-DD.

Where your diary lives

~/.dear-agent/  entries/    2026-06-29.md  media/    2026-06-29/      first-dinner.jpg      morning-thought.ogg

Set DEAR_AGENT_DIR to choose a different location.

Contributing

Issues and pull requests are welcome. Dear Agent is intentionally small and dependency-light — keep changes focused, keep storage as plain files the user owns, and keep everything local-first and private. See ROADMAP.md for where it is headed.

License

MIT © BitmapAsset. Free for anyone, anywhere, in any agent.

Source: README.md at commit 294dc7e

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts