Server data from the Official MCP Registry
Your AI agent keeps your diary for you. Local-first, private, works in any agent.
Your AI agent keeps your diary for you. Local-first, private, works in any agent.
Dear Agent is a well-designed, security-conscious local-first diary MCP server with clean code structure and appropriate authentication model. The server operates entirely on user-owned files in a local directory, implements proper input validation, and avoids external data exfiltration. Minor code quality observations around error handling do not materially impact security posture. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
3 files analyzed · 8 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: DEAR_AGENT_DIR
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-bitmapasset-dear-agent": {
"env": {
"DEAR_AGENT_DIR": "your-dear-agent-dir-here"
},
"args": [
"-y",
"dear-agent"
],
"command": "npx"
}
}
}From the project's GitHub README.
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.
npm install -g dear-agent
Or run it straight from npx (no install):
npx dear-agent
claude mcp add dear-agent -- npx -y dear-agent
Or add to your MCP config:
{
"mcpServers": {
"dear-agent": {
"command": "npx",
"args": ["-y", "dear-agent"]
}
}
}
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.
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.
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.
| 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
| 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.
~/.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.
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.
MIT © BitmapAsset. Free for anyone, anywhere, in any agent.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.