Skip to content
Agentmart
Submit a tool

heropen — AI Agent Memory

Persistent memory for AI agents: local-first MCP server, zero-config.

Connector by heropen.netOfficial · Domain verified by the MCP Registry

IndexedApache-2.0Local (stdio)★ 1
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/heropen-net-heropen

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Persistent memory for AI agents: local-first MCP server, zero-config. No cloud, no API keys.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
3 read · 4 write · 0 delete · 2 not yet classified
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Tools by what they do 9

Read from the source code; the running server may list different tools.

Read 3 · Look things up without changing anything.

  • health
  • list_memory
  • search_memory

Write 4 · Create, change, send or run things.

  • add_memory
  • auto_save_turn
  • session_checkpoint
  • update_memory

Not yet classified 2 · We could not tell from the name and description.

  • prime_conversation
  • session_recover

Tools (9)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • add_memory

    保存信息到用户的长期记忆。在以下情况必须调用： - 用户分享了新的偏好、习惯、约定、项目信息 - 对话中产生了需要后续跟进的事项 - 对话即将结束时，保存本次产生的关键信息 优先主动保存，不要等用户说"记住这个"。content 上限 5000 字。 Args: section: Category/topic for this memory (e.g. '用户偏好', '项目状态', '对话记录'). content: The information to remember (max 5000 chars). Write it clearly so future you can understand it. tags: Comma-separated keywords for better search. agent: Which agent's memory to write to (default: auto). entry_date: Date for this entry (YYYY-MM-DD, default: today).

  • auto_save_turn

    每轮自动存档钩子（heropen 2.0.1）。宿主 / 网关在每轮 assistant 回复完成后调用本工具， 把本轮对话提交给 heropen 存储内核；落库时机仍由该 agent 的存储模式决定 （sentence 立即落 / chunk 攒批落 / auto 智能选），与「是否每轮提交」两层正交。 这是 heropen 的「轮轮不落」安全网：无论模型是否主动调 add_memory，每轮回复都会被提交。 source 固定 auto_turn，便于与显式 add 区分。请勿用本工具替代断点（session_checkpoint）。 Args: content: 本轮 assistant 回复原文（必填）。 agent: 哪个 agent 的记忆（默认自动）。 user_content: 可选，本轮用户输入原文；提供后连用户发言一并存档，还原完整一轮。 section: 分类（默认「对话记录」）。 tags: 额外标签（auto_turn 会自动加上）。 Returns (JSON): {"saved": int, "buffered": int, "flushed": int, "source": "auto_turn", "parts": [{"kind": "user"|"assistant", "writ…

  • health

    Check heropen system health and connection status. Call this when you start up to verify everything is working. If pending_setup is true, it means heropen was just installed — show the welcome_message to the user and ask if they'd like to complete the setup. Args: clear_pending: Set to true after completing initial setup to clear the pending marker.

  • list_memory

    列出用户的记忆列表。用于概览已有记忆、检查冗余、了解记忆总量。 Args: limit: How many recent entries to show (max 50, default 10). agent: Which agent's memories to list.

  • prime_conversation

    对话开始前必须调用：获取当前时间上下文（heropen 自动生成）。 返回自然语言时间区块，包含：当前本地时间、时段词、距上次对话间隔、 是否跨睡眠周期（区分"工作-短休息-工作"与"工作-长休息-继续工作"）、 今日对话轮次、以及相对时间词锚点提示。 把这段文本作为上下文读入，你的寒暄与对"明天/下周"等相对时间的理解才有据可依， 不会出现"晚上说早上好"或把用户凌晨说的"明天"误判为字面次日。 返回内容开头会带一行「开场签名」（品牌 + 状态），形如： heropen 已就绪 · 本地记忆 187 条 · 距上次对话约 3 小时 · agent=xiaokai Args: agent: Which agent's context to prime (default: auto).

  • search_memory

    搜索用户的长期记忆。在以下情况必须调用： - 对话开始时，了解用户背景和历史 - 用户提到人名、项目名、偏好等关键词时 - 用户询问"还记得吗"或类似问题时 不要等用户要求才搜索。主动搜索能让你更懂用户。三层回退：向量 → 全文 → 模糊匹配。 Args: query: Keywords to search for. Use the user's own words or inferred topics. limit: Max results (1-20, default 5). agent: Which agent's memory to search (default: auto). date_from: Only return entries on or after this date (YYYY-MM-DD). date_to: Only return entries on or before this date (YYYY-MM-DD).

  • session_checkpoint

    Save a session checkpoint. Call periodically during long conversations so the agent can recover context after compression or restart. Args: agent: Which agent's memory context_summary: Summary of current conversation context active_task: What task is currently being worked on key_decisions: Comma-separated key decisions made so far tags: Extra comma-separated tags

  • session_recover

    Recover the most recent session checkpoint(s). Use after context compression or agent restart to pick up where you left off. Args: agent: Which agent's memory limit: Number of recent checkpoints (default 1, max 5)

  • update_memory

    Update an existing memory entry. Only provided fields are changed.

Signals

Stars
1
Forks
0
Open issues
0
Weekly downloads
206
Last commit
Oct 23, 2026 (5 days ago)
Last release
Oct 23, 2026 (5 days ago)
Last package publish
Oct 23, 2026 (5 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
net.heropen/heropen
Version
2.0.6
Auth
No auth
Packages
pypi heropen
License
Apache-2.0
Repository
github.com/Koradji77/heropen
Website
heropen.net
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

heropen — AI Agent Memory MCP server. Agent Mart. https://agentmart.dev/connectors/heropen-net-heropen (last updated 2026-10-24)