# Become Human

> Become Human is an open-source MCP server for knowledge and memory. Give coding agents a profile of how you work, per-project maps and your own rules. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/201tech/become-human
- **MCP Registry name:** io.github.DanielDDHM/become-human
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

Closing a session usually means the agent forgets you. BecomeHuman keeps three plain-text things in `~/BecomeHuman` so the next session picks up: a `profile.md` of what it learned about you, a `my-rules.md` of your own rules that override defaults, and one checklist per project holding ideas, decisions, open questions and next steps.

The README shows the effect: say "let's continue" and the agent recalls where it stopped and asks the open question. Its stated rules have the agent ask before choices that shape the work, explain things at your level and keep you informed. The profile holds at most 50 facts by default and merges similar ones, adjustable with `BECOME_HUMAN_PROFILE_LIMIT`, and `BECOME_HUMAN_LANG` switches files between English and Portuguese.

It installs with Node 20+ via `npx -y become-human` as an MCP server or, for Claude Code, as a plugin. MIT licensed.

## Features

- **Learned profile:** Preferences and corrections saved so it never asks twice.
- **Project maps:** A checklist per project for decisions and next steps.
- **Your own rules:** Rules in my-rules.md override defaults.
- **Plain-text files:** Everything is editable in ~/BecomeHuman.
- **Language setting:** Files in English or Portuguese.
- **Works across agents:** Claude Code, Codex, Gemini CLI, Cursor and others.

## Good for

- Resume a project without re-explaining it
- Teach an agent a coding style once
- Keep a decision log per project
- Sync agent memory via a shared folder

## Install

### Claude Code (Terminal)

```sh
claude mcp add become-human -- npx -y become-human
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "become-human": {
      "command": "npx",
      "args": [
        "-y",
        "become-human"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "become-human": {
      "command": "npx",
      "args": [
        "-y",
        "become-human"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "become-human": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "become-human"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "become-human": {
      "command": "npx",
      "args": [
        "-y",
        "become-human"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "become-human": {
      "command": "npx",
      "args": [
        "-y",
        "become-human"
      ]
    }
  }
}
```

## FAQ

### Where is my data stored?

In ~/BecomeHuman on your computer, or the folder set by BECOME_HUMAN_HOME.

### How many facts does the profile keep?

50 by default, changeable with an environment variable.

### What is needed to install?

Node.js 20 or newer.

### Which agents work?

Claude Code, Codex, Cursor, Gemini CLI and other MCP agents.

### Is Become Human free?

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

### How do I add Become Human to Claude Code?

Run this command in your terminal: claude mcp add become-human -- npx -y become-human

### What are the best alternatives to Become Human?

The closest alternatives to Become Human are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Concord MCP.

## Where this comes from

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

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.

---
Source: https://ai-powered.com/mcp/become-human
