Claude plugin

The HyperMemory plugin connects the MCP server, installs the HyperMemory skill and hooks, and adds the background memory-writer agent.

Where you install it decides where it works:

In the Claude app (Customize → Plugins), the plugin is saved to your Claude account, so it works in Claude chat on the web, desktop and mobile, in Cowork, and in Claude Code. Install it there once.
From the Claude Code command line (/plugin install), it works only in Claude Code on that computer.

Before you start

Claude Code, in the terminal or the desktop app
A HyperMemory account — sign up free
bash and python3 on your PATH (the hooks use them)

Install with one instruction

Paste this into Claude Code — or the Code or Cowork tab of the Claude desktop app. Claude runs the commands for you:

Install the HyperMemory plugin from https://github.com/hypermemory-ai/hm-plugins-claude
(first make sure Python 3 and Git are installed on this computer and install them if
they are missing), then start the HyperMemory OAuth sign-in so the authentication page
opens in my browser and wait for me to approve it, and finally download and install the
latest HyperMemory skill.

Restart Claude when it asks, so the hooks load. This installs the plugin for Claude Code on this computer. To have HyperMemory in Claude chat as well, install it in the Claude app instead.

Install in the Claude app (all of Claude)

Add the marketplace

In claude.ai or the Claude desktop app, open Customize → Plugins, select Add → Add marketplace and enter hypermemory-ai/hm-plugins-claude.

Install the plugin

Select hypermemory and click Install. Claude warns that the plugin doesn't come from Anthropic; HyperMemory publishes it from that repository.

Connect HyperMemory

Installing doesn't sign you in. Open the plugin's Connectors tab, connect HyperMemory, and approve the sign-in in your browser.

Start Claude Code once

Claude Code picks up the plugin the next time you start a session signed in to the same account (or run /reload-plugins). That first session sets up your CLAUDE.md files and the nightly update task.

Where	What you get
Claude chat (web, desktop, mobile)	The HyperMemory tools and skills. Chat runs no hooks or agents, so recall isn’t enforced and there is no background memory-writer: Claude saves memories with the tools itself.
Cowork	The tools, skills and the memory-writer agent.
Claude Code	The whole plugin: tools, skills, hooks and the memory-writer.

If you also installed the plugin from the command line before, remove that copy once the synced one appears, so Claude Code doesn’t load it twice: claude plugin uninstall hypermemory@hypermemory-plugins.

Install it yourself (Claude Code only)

Add the marketplace

/plugin marketplace add hypermemory-ai/hm-plugins-claude

Install the plugin

/plugin install hypermemory@hypermemory-plugins

Review the hooks

Run /hooks to see the HyperMemory hooks, then restart Claude Code so they load.

The first time the agent calls a HyperMemory tool, Claude Code opens your browser. Sign in to HyperMemory and approve the connection. Tokens refresh automatically after that.

From a shell, the same install is:

claude plugin marketplace add hypermemory-ai/hm-plugins-claude
claude plugin install hypermemory@hypermemory-plugins

Verify

Run /plugin list and check that hypermemory is enabled, then ask:

What do you know about me?

The agent should call hm_get_overview and hm_recall before answering.

What the plugin installs

Skills

Skill	Invoke	What it does
`hypermemory`	Automatic, every turn	The HyperMemory protocol: recall before replying, use organization memory, hand the turn to the memory-writer.
`memorize-full-chat`	`/hypermemory:memorize-full-chat`	Commit an entire conversation to memory, one node per entity and fact, cross-linked.

Hooks

Event	What it does
SessionStart	Adds the HyperMemory section, where it is missing, to your user-level `~/.claude/CLAUDE.md` (every project on the computer), the session’s project `CLAUDE.md` and the `CLAUDE.md` of every project Claude Code knows, so the section also travels with each repository. Schedules the nightly update task if it isn’t scheduled yet. Loads the skill.
UserPromptSubmit	Loads the skill into context on every prompt, so the protocol survives long sessions and compaction.
Stop	Checks that the turn dispatched the memory-writer before ending. Short greetings and acknowledgements are exempt.

Agent

memory-writer runs in the background at the end of each turn. It stores new facts as separate, well-described nodes; updates memories that changed; links them to their siblings; writes a timeline entry; and reports the turn’s token usage with hm_tokens. The main agent never waits for it.

Nightly update task

The first Claude Code session in the Claude desktop app schedules a task, HyperMemory nightly update check, that runs every night at midnight while the app is open:

updates the plugin when you installed it from the command line (the Claude app keeps a plugin installed there up to date by itself);
reports when the HyperMemory server has a newer skill than the plugin carries;
updates the skills in ~/.claude/skills that HyperMemory, your organizations or you have published newer versions of, checking every file against its published checksum and keeping a backup.

You see it, and can pause or run it, in the Claude app’s scheduled tasks. In the Claude Code terminal outside the desktop app it can’t be scheduled; the agent tells you so.

Organizations

If you belong to a HyperMemory organization, its memory is searched with yours on every recall.

If you belong to several organizations, each project is bound to one of them (or to none) in ~/.config/hypermemory/projects.json. The first time you open an unbound project, the agent asks which organization it belongs to and saves your answer. All worktrees of a repository share one binding. See Organization memory.

Update

A plugin installed in the Claude app updates from the marketplace by itself. For a command-line install, the nightly task updates it, or run:

/plugin marketplace update hypermemory-plugins
/plugin update hypermemory@hypermemory-plugins

Restart Claude Code after updating.

Uninstall

In the Claude app, open the plugin under Customize → Plugins and select Remove. For a command-line install:

/plugin uninstall hypermemory@hypermemory-plugins
/plugin marketplace remove hypermemory-plugins

Removing the plugin doesn’t delete anything from your memory. The HyperMemory sections in your CLAUDE.md files and the nightly update task stay until you remove them: delete the sections, and delete the task in the Claude app’s scheduled tasks.

Without the plugin

You can also connect Claude Code to the MCP server directly. You get the tools, but not the skill, hooks or memory-writer, so the agent only uses memory when you ask it to.

claude mcp add --transport http hypermemory https://api.hypermemory.io/mcp

Or let the CLI install the skill, hooks and writer for you without the marketplace: hm setup claude. See CLI.

Troubleshooting

The agent doesn't call hm_recall

Run /plugin list to confirm the plugin is enabled, and /hooks to confirm the HyperMemory hooks are loaded. Restart Claude Code after installing or updating.

I installed an early version and the tools stopped working

Versions before 2.12.2 connected to a pre-release server. Update the plugin and sign in again.

Recall says selection_required

You belong to several organizations and this project isn't bound to one. Answer the agent's question, or edit ~/.config/hypermemory/projects.json.