Client Guides
Claude/Claude Code
Set up HyperMemory in Claude Code, the Claude desktop app and claude.ai
Where you use Claude decides how HyperMemory is installed:
| Where | How |
|---|---|
| All of Claude (chat on web, desktop and mobile, Cowork, Claude Code) | The HyperMemory plugin, installed once in the Claude app under Customize → Plugins. It is saved to your Claude account. |
| Claude Code only, on one computer | The HyperMemory plugin, installed from the Claude Code command line |
| claude.ai chat without the plugin | A connector plus the HyperMemory skill |
Install with one instruction
Paste this into Claude:
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.
Claude will:
- Check that Python 3 and Git are installed — the plugin’s hooks use them.
- Add the
hypermemory-pluginsmarketplace and install thehypermemoryplugin. - Open HyperMemory’s sign-in page in your browser. Sign in and approve the connection.
- Fetch the latest HyperMemory skill with
hm_skill.
Restart Claude when it asks, so the plugin’s hooks load. This installs the plugin for Claude Code on this computer. See Claude plugin for what the plugin installs and how to update or remove it.
Install it in the Claude app (all of Claude)
- In claude.ai or the Claude desktop app, open Customize → Plugins, select Add → Add marketplace and enter
hypermemory-ai/hm-plugins-claude. - Select hypermemory and click Install.
- Open the plugin’s Connectors tab, connect HyperMemory and approve the sign-in in your browser.
The plugin then works in Claude chat, Cowork and Claude Code. Chat uses its tools and skills; hooks and the memory-writer run in Claude Code (and the writer in Cowork). Claude Code loads it the next time you start a session signed in to the same account.
Install it yourself (Claude Code only)
/plugin marketplace add hypermemory-ai/hm-plugins-claude
/plugin install hypermemory@hypermemory-plugins
Then restart Claude, run /mcp, select hypermemory and choose Authenticate.
claude.ai chat
The simplest way to get HyperMemory in chat is the plugin, installed in the Claude app as described above. Without the plugin, add HyperMemory as a connector, then install the skill.
Add the connector
Open Settings → Connectors, choose Add custom connector, name it HyperMemory and paste:
Sign in
Choose Connect, sign in to HyperMemory and approve the connection.
Install the skill
Make sure Skills are on in Settings → Capabilities, then ask Claude:
Download the latest HyperMemory skill for Claude into my skills list as a .skill file and install it.
You can also download it from app.hypermemory.io/hypermemory-skill.md and upload it yourself.
On Team and Enterprise plans, an owner may need to add the connector for the organization first.
Verify
Ask:
What do you know about me?
Claude should call hm_get_overview and hm_recall before it answers.
Plugin or connector?
| Plugin in Claude Code | Plugin in Cowork | Plugin in chat | Connector only (chat) | |
|---|---|---|---|---|
| Memory tools | ✓ | ✓ | ✓ | ✓ |
| HyperMemory skill | Included | Included | Included | Install once |
| Hooks that make Claude recall and save every turn | ✓ | — | — | — |
| Background memory-writer agent | ✓ | ✓ | — (Claude saves in the conversation) | — (Claude saves in the conversation) |
Troubleshooting
Claude doesn't use memory unless I ask
Claude doesn't use memory unless I ask
With the plugin: run /plugin list and /hooks to check that it's enabled, then restart Claude. With the connector: install the skill and start a new chat with the connector enabled.
The sign-in page doesn't open
The sign-in page doesn't open
In Claude Code, run /mcp, select hypermemory and choose Authenticate. In claude.ai, open Settings → Connectors, select HyperMemory and choose Connect.
I belong to several organizations
I belong to several organizations
The plugin asks which organization a project uses the first time you open it. In claude.ai chat, tell Claude which organization the conversation is about. See Organization memory.