Skip to content
MCP server

Become Human

Give coding agents a profile of how you work, per-project maps and your own rules

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.6.3
Listing updated
today

Similar MCP servers

About Become Human

Become Human is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "become-human": {
      "command": "npx",
      "args": [
        "-y",
        "become-human"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "become-human": {
      "command": "npx",
      "args": [
        "-y",
        "become-human"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • BECOME_HUMAN_LANGLanguage of your files: en or pt
  • BECOME_HUMAN_HOMEFolder for your profile, rules and maps
  • BECOME_HUMAN_PROFILE_LIMITMaximum facts kept in your profile

What it does

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

Pricing

Open source

Free, MIT licensed

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.

How AIPoweredBot checks servers