Provides AI agents with long-term memory of user preferences, project context, and decision history to create a collaborative partnership.
Also known as 201Tech/become-human
- Stars
- 2
- Tools
- 8
- Downloads, 30 days
- —
- Latest version
- 0.6.3
- Last commit
- Nov 12, 2026
- License
- MIT
What is BecomeHuman MCP?
BecomeHuman provides AI agents with long-term memory of user preferences, project context, and decision history to create a collaborative partnership. It exposes 8 tools, such as get_rules, remember, forget.
Summary generated from the project's README
About BecomeHuman MCP server
Giving AI agents long-term memory of your preferences and project history is what become-human enables for developers using MCP-compatible clients. It transforms agents from session-based tools into collaborative partners that remember specific coding styles, project decisions, and pending questions. This server works locally on your machine using Node.js 20 or newer, storing all data in a plain text directory at ~/BecomeHuman.
Users can integrate this server with Claude Code, Cursor, Windsurf, Gemini CLI, and Codex by adding it to their MCP configuration. It manages information through specific files like profile.md for personal traits, my-rules.md for custom instructions, and project-specific maps for tracking ideas and next steps. You can customize the experience by setting environment variables to change the language, adjust the profile fact limit, or move the storage folder to a different location.
What you can do with it
- 1Maintain coding style consistencyAsk the agent to remember your specific formatting preferences so it stops using certain syntax like semicolons.
- 2Track project progress across sessionsHave the agent recall exactly where a specific task left off during your last interaction.
Written from the project's README. Every use case is checked against a quote from it.
How to install BecomeHuman MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall BecomeHuman MCP in Claude Code
$ claude mcp add become-human -- npx -y become-humanInstall BecomeHuman MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"become-human": {
"command": "npx",
"args": [
"-y",
"become-human"
]
}
}
}Install BecomeHuman MCP in VS Code
.vscode/mcp.json
{
"servers": {
"become-human": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"become-human"
]
}
}
}Install BecomeHuman MCP in VS Code CLI
$ code --add-mcp '{"name":"become-human","type":"stdio","command":"npx","args":["-y","become-human"]}'Install BecomeHuman MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"become-human": {
"command": "npx",
"args": [
"-y",
"become-human"
]
}
}
}Install BecomeHuman MCP in Codex
$ codex mcp add become-human -- npx -y become-humanInstall BecomeHuman MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.become-human] command = "npx" args = ["-y", "become-human"]
Install BecomeHuman MCP in Gemini CLI
$ gemini mcp add -s user become-human npx -- -y become-humanInstall BecomeHuman MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"become-human": {
"command": "npx",
"args": [
"-y",
"become-human"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for become-human 0.6.3 in an isolated container with no network and no keys. It answered and listed 8 tools.
BecomeHuman MCP tools 8
Read from the server with tools/listget_rulesReread the rules for working with your human.
rememberSave one preference, habit or correction about your human. Tell them in one line.
forgetRemove a learned fact. Pass words from it; it must match exactly one fact.
get_profileEverything learned about how your human works.
get_mapFull idea map of a project, plus what is still open.
map_addRecord an idea, decision, question or next step. parentId links it to a node.
map_resolveMark a question answered or a next step done.
where_is_my_dataWhere the human's BecomeHuman files are and what each holds.
Configuration
BECOME_HUMAN_HOMEFolder for your profile, rules and maps
BECOME_HUMAN_LANGLanguage of your files: en or pt
BECOME_HUMAN_PROFILE_LIMITMaximum facts kept in your profile
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachable201tech/become-human is public and reachablegithub.com/201tech/become-human ↗Pass
- Package names this repository as its sourcebecome-human names 201tech/become-human as sourcenpmjs.com/package/become-human ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/201tech/become-human ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from become-humanPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubBecomeHuman
Your AI agent, working with you. Not just for you.
Install · What changes · Your files · Make it yours
Why
AI agents are fast, but they forget you every session, decide things you wanted to decide, and leave work you cannot follow. BecomeHuman fixes that in any agent that speaks MCP: Claude Code, Codex, Cursor, Gemini CLI and others.
Install
Run it once per computer. From then on your agent starts it by itself, every session.
Claude Code, as a plugin (inside a session):
/plugin marketplace add 201Tech/become-human
/plugin install become-human@become-human
Or as an MCP server, which also lets you pass settings:
claude mcp add become-human --scope user -- npx -y become-human
codex mcp add become-human -- npx -y become-human
gemini mcp add -s user become-human npx -y become-human
For Cursor, Windsurf, Claude Desktop and any other agent, add this to its MCP config:
{
"mcpServers": {
"become-human": {
"command": "npx",
"args": ["-y", "become-human"]
}
}
}
You only need Node.js 20 or newer.
What changes
You: let's continue Agent: Last time we left off at #4 "add the login screen". There is also an open question: email or phone? Which do you prefer? You: email, and stop using semicolons Agent: Done. Learned: you prefer code without semicolons.
- It does the work and keeps you in the loop: what it will do, why, and what changed.
- You lead: it asks before any choice that shapes the work, and your word is final.
- It makes your life easier: it spots what slows you down and offers to fix it, only with your consent.
- It teaches: plain explanations, adapted to how much you already know.
- It learns how you work: your preferences and corrections, so it never asks twice.
- It remembers each project: code, writing, research or planning: ideas, decisions, questions, next steps.
- It is a real partner: matches your tone, notices when you are tired, admits mistakes, disagrees with respect.
Read the full rules in rules/human-first.md.
Your files
Everything stays on your computer, in a folder you can open: ~/BecomeHuman.
| File | What is inside |
|---|---|
profile.md |
What the agent learned about you, grouped by topic |
my-rules.md |
Your own rules for every agent |
maps/<project>.md |
One checklist per project: ideas, decisions, questions, next steps |
They are plain text. Read them, fix them, add notes: the agent follows what is there and never erases what you wrote. Not sure where they are? Ask your agent: "where is my data?"
Make it yours
- Your rules: write them in
~/BecomeHuman/my-rules.md, one per line. They win over the defaults. - Your language: set
BECOME_HUMAN_LANG=ptto get your files in Portuguese (enis the default). - Another folder: set
BECOME_HUMAN_HOMEto keep the files elsewhere, like a synced folder. - Profile size: the agent keeps at most 50 facts and merges similar ones. Change it with
BECOME_HUMAN_PROFILE_LIMIT.
To pass a setting to Claude Code, add -e when installing:
claude mcp add become-human --scope user -e BECOME_HUMAN_LANG=pt -- npx -y become-human
Contributing
See CONTRIBUTING.md. License: MIT.
BecomeHuman MCP questions
How do I add BecomeHuman MCP to Claude Code?
Run claude mcp add become-human -- npx -y become-human in your terminal. Add --scope user to make it available in every project.
How do I add BecomeHuman MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does BecomeHuman MCP provide?
It exposes 8 tools, including get_rules, remember, forget, get_profile, get_map.
Does the agent remember my specific project details?
Yes, it maintains project-specific maps containing ideas, decisions, questions, and next steps.