# Memory Pulse

> Memory Pulse is a freemium MCP server for knowledge and memory. Corrections-first agent memory with a guard that blocks edits reintroducing retired values. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/t-crew/memory-pulse
- **MCP Registry name:** io.github.t-crew/memory-pulse
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Memory Pulse keeps a ledger of cause-and-effect events in a file inside your own repository. A finding marked as a correction outranks everything at every brief size and never decays, and a guard blocks any edit that writes a retired value back, quoting the line that retired it. When recall cannot clear its confidence floor it returns nothing rather than a weak guess.

The README describes built-in memory security: a stored note that reads like an instruction never reaches the agent, and each row is hash-chained so any edit to the record shows. Four tools make up the surface, about 900 tokens of definitions by the README's measurement. remember runs locally and offline, while pulse, recall and execute use a hosted engine.

It works with Claude Code, Codex, Cursor, any stdio MCP client and GitHub Actions through hooks and plugins. A licence key is optional, and the README says there is a free tier without one. Setting a board file path adds board_post and board_read for messages between agents.

## Features

- **Corrections first:** Corrections outrank other memories and never decay.
- **Edit guard:** Blocks an edit that writes a retired value back.
- **Hash-chained ledger:** Any edit to the stored record shows.
- **Injection filter:** Stored notes that read like instructions never reach the agent.
- **Small tool footprint:** Four tools totalling about 900 tokens of definitions.
- **Multi-host hooks:** Installs hooks for Claude Code, Codex and Cursor.

## Good for

- Stop an agent re-adding a value you withdrew
- Open each session on a ranked brief of prior findings
- Trace what caused a past regression
- Let several agents share a message board

## Install

### Claude Code (Terminal)

```sh
claude mcp add memory-pulse --env MEMORY_PULSE_KEY='<MEMORY_PULSE_KEY>' -- npx -y memory-pulse
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "memory-pulse": {
      "command": "npx",
      "args": [
        "-y",
        "memory-pulse"
      ],
      "env": {
        "MEMORY_PULSE_KEY": "<MEMORY_PULSE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "memory-pulse": {
      "command": "npx",
      "args": [
        "-y",
        "memory-pulse"
      ],
      "env": {
        "MEMORY_PULSE_KEY": "<MEMORY_PULSE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "memory-pulse": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "memory-pulse"
      ],
      "env": {
        "MEMORY_PULSE_KEY": "<MEMORY_PULSE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "memory-pulse": {
      "command": "npx",
      "args": [
        "-y",
        "memory-pulse"
      ],
      "env": {
        "MEMORY_PULSE_KEY": "<MEMORY_PULSE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "memory-pulse": {
      "command": "npx",
      "args": [
        "-y",
        "memory-pulse"
      ],
      "env": {
        "MEMORY_PULSE_KEY": "<MEMORY_PULSE_KEY>"
      }
    }
  }
}
```

## Tools

- `remember`: Record a finding or a correction locally and offline.
- `pulse`: Re-enter the project on a ranked brief sized to a budget.
- `recall`: Ask what caused X, what X caused, or when the link was strongest.
- `execute`: Run JavaScript against memory in a sandbox so only the return value enters context.
- `board_post`: Post to a shared agent message board when a board file is set.
- `board_read`: Read the shared agent message board when a board file is set.

## FAQ

### Where is the memory stored?

In a local ledger file, by default ./.memory-pulse/events.jsonl, inside your repository.

### Is there a free tier?

The registry entry says a licence key is optional and there is a free tier without one.

### Which tools run offline?

remember runs locally and offline; pulse, recall and execute use a hosted engine.

### How do I install it?

Register the stdio server with npx -y memory-pulse, or use the install script or a plugin.

### Is Memory Pulse free?

Memory Pulse has a free plan, with paid plans for more usage or features.

### How do I add Memory Pulse to Claude Code?

Run this command in your terminal: claude mcp add memory-pulse --env MEMORY_PULSE_KEY='<MEMORY_PULSE_KEY>' -- npx -y memory-pulse

### What are the best alternatives to Memory Pulse?

The closest alternatives to Memory Pulse are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/memory-pulse
