# PyMemoryEditor

> PyMemoryEditor is an open-source MCP server for developer tools. Scan, read and write another process's memory from an AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, Linux, macOS, CLI
- **Website:** https://pymemoryeditor.readthedocs.io/en/latest/mcp.html
- **Repository:** https://github.com/jeanextreme002/pymemoryeditor
- **MCP Registry name:** io.github.JeanExtreme002/PyMemoryEditor
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

PyMemoryEditor's MCP server hands an assistant the search loop of a memory scanner: list processes, attach to one, scan for a value, narrow the matches as the value changes, and read or write the address it settles on. In the README's example, you say a game's health is 100, the assistant scans, asks you to take damage, refines the matches and returns the address.

Consent is built in. Attaching to a process you have not pre-approved asks permission, and write_value asks for confirmation on clients that honour the requiresUserInteraction hint, such as Claude Code. `--read-only` removes the write tool, and on Windows also opens the process handle without write rights; `--confirm-writes` makes the server itself ask before each write. The docs warn that it runs with your privileges and is not a sandbox.

The server is part of a pure-Python ctypes library for Windows, Linux and macOS, installed with the `mcp` extra. Fourteen tools keep scan results behind a handle on the server so a large first scan does not flood the model's context.

## Features

- **Cheat Engine style loop:** Scan, narrow, then read or write the converged address.
- **Per-process consent:** Attaching to an unapproved process asks for your permission.
- **Write confirmation:** write_value can ask before every write; flags make that mandatory.
- **Read-only mode:** `--read-only` removes the write tool entirely.
- **Handle-based results:** Scan hits stay server-side so large scans use few tokens.
- **Three operating systems:** Runs on Windows, Linux and macOS, 32-bit and 64-bit.

## Good for

- Find a value in a running game by repeated scanning
- Inspect the live state of a program you are debugging
- Have an assistant locate a changing counter after you trigger it
- Script safe, read-only memory inspection in CI

## Install

### Claude Code (Terminal)

```sh
claude mcp add pymemoryeditor -- uvx pymemoryeditor
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pymemoryeditor": {
      "command": "uvx",
      "args": [
        "pymemoryeditor"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pymemoryeditor": {
      "command": "uvx",
      "args": [
        "pymemoryeditor"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "pymemoryeditor": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pymemoryeditor"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pymemoryeditor": {
      "command": "uvx",
      "args": [
        "pymemoryeditor"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pymemoryeditor": {
      "command": "uvx",
      "args": [
        "pymemoryeditor"
      ]
    }
  }
}
```

## Tools

- `write_value`: Writes a value to a process address; clients can be asked to confirm each write.

## FAQ

### Can it modify memory?

Yes through write_value, unless you start the server with `--read-only`.

### Does it ask before attaching?

Yes, unless you pre-approve with `--allow-process` or `--allow-any-process`.

### How do I install it?

`pip install "PyMemoryEditor[mcp]"`, then register `pymemoryeditor-mcp` with your client.

### Is it a sandbox?

No. The docs say it runs with your privileges, so read the safety notes first.

### Is PyMemoryEditor free?

Yes. PyMemoryEditor is open source, so you can use and self-host it for free.

### How do I add PyMemoryEditor to Claude Code?

Run this command in your terminal: claude mcp add pymemoryeditor -- uvx pymemoryeditor

### What are the best alternatives to PyMemoryEditor?

The closest alternatives to PyMemoryEditor are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/pymemoryeditor
