Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.BitmapAsset/dear-agent

NPM · DEAR-AGENT · SCANNED AUG 3

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

Available components

+19 this week 64 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability61
  • 50% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Partial
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 740 tokens (~56/item across 13 items; 11 tools + 2 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage81
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 44% of tool parameters carry a description.Partial
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · dear-agent

# add to Claude Code
claude mcp add bitmapasset-dear-agent -- npx -y dear-agent
# add to Codex CLI
codex mcp add bitmapasset-dear-agent -- npx -y dear-agent
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bitmapasset-dear-agent": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "dear-agent"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add bitmapasset-dear-agent --command npx --arg -y --arg dear-agent
# ~/.hermes/config.yaml
mcp_servers:
  bitmapasset-dear-agent:
    command: "npx"
    args: ["-y", "dear-agent"]
// mcp.json
{
  "mcpServers": {
    "bitmapasset-dear-agent": {
      "command": "npx",
      "args": [
        "-y",
        "dear-agent"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 −3

    No change was recorded against any check on this day. Supply Chain Security went from 97 to 87. Other categories moved too: Stability & Change Management rose 4.

  • 2 Aug 26 +46
    • Provenance: unverified → fail security
    • Malware scan: unverified → pass security
    • Install scripts: unverified → pass security
    • Known CVEs: unverified → partial security
    • License: unverified → pass functional
    • MCP protocol: unverified → pass functional
    • Stability: unverified → 0.23 functional
    • Schema quality: unverified → good functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • Licence: MIT functional
  • 31 Jul 26 −3
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 28 Jul 26 −21
    • Schema quality: 50 → unverified functional
    • Tool coverage: 100 → unverified functional
  • 27 Jul 26 45

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 11 exposed · ~729 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
add_entry ~124

Record a text moment in the user's diary. Capture whenever they share something worth remembering — an event, feeling, win, or decision. The user never types into an app; you keep the diary for them.

NameTypeReqDescription
datestringDay: "today" (default), "yesterday", or YYYY-MM-DD.
moodstringOptional one-word mood.
tagsarrayOptional short tags, e.g. work, family, health.
textstringyesWhat happened, in the user's own meaning, first person where it fits.

No output schema declared.

No examples provided.

add_photo ~81

Save a photo into the user's diary for a day (local path or base64), with an optional caption.

NameTypeReqDescription
captionstring
datastring
datestringDay: "today" (default), "yesterday", or YYYY-MM-DD.
filenamestring
pathstring

No output schema declared.

No examples provided.

add_voice_note ~83

Save a voice note into the user's diary for a day (local path or base64), with an optional transcript.

NameTypeReqDescription
datastring
datestringDay: "today" (default), "yesterday", or YYYY-MM-DD.
filenamestring
pathstring
transcriptstring

No output schema declared.

No examples provided.

get_day ~49

Read back one day's full diary entry, including any photos and voice notes filed that day.

NameTypeReqDescription
datestringDay: "today" (default), "yesterday", or YYYY-MM-DD.

No output schema declared.

No examples provided.

get_range ~31

Read diary entries between two dates (inclusive).

NameTypeReqDescription
endstringyes
startstringyes

No output schema declared.

No examples provided.

list_days ~21

List every day that has a diary entry, oldest to newest.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

on_this_day ~56

Resurface entries from this same calendar date in past years (true anniversaries). The memory people fall in love with.

NameTypeReqDescription
datestringDay: "today" (default), "yesterday", or YYYY-MM-DD.

No output schema declared.

No examples provided.

recall ~113

Turn the diary into living memory of the person. With `about`, returns everything the diary knows about a person/place/topic across time. Without it, returns a profile digest (recurring people, themes, mood pattern, open commitments) for you to synthesize into who this person is. This is what makes Dear Agent a memory, not just a notebook.

NameTypeReqDescription
aboutstringA person, place, project, or topic to recall. Omit for a whole-life profile digest.
limitinteger

No output schema declared.

No examples provided.

reflect ~84

Get reflection material so you can proactively talk back to the user: patterns, progress, open loops, and on-this-day memories over the last week or month. Use for a daily check-in or weekly recap so the diary feels alive.

NameTypeReqDescription
endstringDay: "today" (default), "yesterday", or YYYY-MM-DD.
periodstring

No output schema declared.

No examples provided.

search ~37

Search the whole diary for a word or phrase; returns matching days with snippets.

NameTypeReqDescription
limitinteger
querystringyes

No output schema declared.

No examples provided.

weekly_digest ~50

Pull the last 7 days of entries so you can write the user a short weekly reflection.

NameTypeReqDescription
endstringDay: "today" (default), "yesterday", or YYYY-MM-DD.

No output schema declared.

No examples provided.