How do I install Dear Agent?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Dear Agent need an API key?

The publisher lists these environment variables: DEAR_AGENT_DIR.

What transport does Dear Agent use?

Dear Agent runs locally over stdio.

When was Dear Agent last checked?

Last checked 2026-11-08. Your AI agent keeps your diary for you. Local-first, private, works in any agent.

Dear Agent MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

DEAR_AGENT_DIR — Directory where the diary is stored as plain markdown (default ~/.dear-agent).

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1DEAR_AGENT_DIR=<value> claude mcp add io.github.bitmapasset-dear-agent -- npx -y dear-agent@0.2.3

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.bitmapasset-dear-agent": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "DEAR_AGENT_DIR": "<value>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.2.3
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Dear Agent

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

npm install -g dear-agent

Or run it straight from npx (no install):

npx dear-agent

Claude Code / Claude Desktop

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

Or add to your MCP config:

{
  "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

Interface	How
MCP tools	11 tools (below) over stdio.
MCP prompts	`daily_checkin`, `weekly_reflection` — surface as slash-commands.
MCP resources	`diary://today`, `diary://index`.
Skill	`SKILL.md` for skill-based harnesses (Claude Code, OpenClaw).
CLI	`dear-agent add "..."`, `recall`, `reflect`, … — for any agent that can run a shell.

CLI examples:

dear-agent add "Closed the interview, felt good." --mood hopeful --tags job,win
dear-agent recall Sarah
dear-agent reflect week
dear-agent on-this-day

Tools

Tool	What it does
`add_entry`	Save a text moment (optional mood, tags) for a day.
`add_photo`	Save a photo for a day (local path or base64), with a caption.
`add_voice_note`	Save a voice note for a day, with an optional transcript.
`get_day`	Read one day's full entry.
`get_range`	Read entries between two dates.
`search`	Find days matching a word or phrase.
`recall`	What the diary knows about a person/topic, or a whole-life profile digest.
`reflect`	Patterns, progress, open loops, and on-this-day, for a proactive check-in.
`on_this_day`	Resurface this same calendar date from past years.
`weekly_digest`	Pull the last 7 days for a reflection.
`list_days`	List 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.

Dear Agent

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Dear Agent?

Does Dear Agent need an API key?

What transport does Dear Agent use?

When was Dear Agent last checked?

Documentation

Dear Agent

Why it is different

Install

Claude Code / Claude Desktop

Cursor / OpenClaw / other MCP clients

How you use it

It remembers you, and it talks back

Works with any agent, harness, or interface

Tools

Where your diary lives

Contributing

License