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:

WhereHow
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 computerThe HyperMemory plugin, installed from the Claude Code command line
claude.ai chat without the pluginA 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:

  1. Check that Python 3 and Git are installed — the plugin’s hooks use them.
  2. Add the hypermemory-plugins marketplace and install the hypermemory plugin.
  3. Open HyperMemory’s sign-in page in your browser. Sign in and approve the connection.
  4. 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)

  1. In claude.ai or the Claude desktop app, open Customize → Plugins, select Add → Add marketplace and enter hypermemory-ai/hm-plugins-claude.
  2. Select hypermemory and click Install.
  3. 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.

1

Add the connector

Open Settings → Connectors, choose Add custom connector, name it HyperMemory and paste:

https://api.hypermemory.io/mcp
2

Sign in

Choose Connect, sign in to HyperMemory and approve the connection.

3

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 CodePlugin in CoworkPlugin in chatConnector only (chat)
Memory tools✓✓✓✓
HyperMemory skillIncludedIncludedIncludedInstall 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

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.

In Claude Code, run /mcp, select hypermemory and choose Authenticate. In claude.ai, open Settings → Connectors, select HyperMemory and choose Connect.

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.