Provides an AI identity layer that allows LLMs to access and update a portable, plain-text profile of your values, skills, and focus.
Also known as paperdavid/manoma, manoma-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.2.1
- Last commit
- Sep 12, 2026
- License
- MIT
What is manoma MCP?
manoma provides an AI identity layer that allows LLMs to access and update a portable, plain-text profile of your values, skills, and focus.
Summary generated from the project's README
About manoma MCP server
Manoma provides a way for developers to maintain a portable identity layer through a plain-text file called soul.md. This file contains your values, skills, and current focus, allowing different AI models to understand your context without relying on vendor-specific cloud storage. Because the identity lives as a local file on your machine, you can version it with git and move it between different tools and environments.
Users interact with this system via a CLI or by adding the MCP server to clients like Claude Desktop or Cursor. The server provides six specific tools including get_context, get_skill_depth, list_sections, add_decision, add_lesson, and update_now. These tools allow an AI to read your profile and propose updates based on your interactions. This setup ensures that your identity remains under your direct control rather than being locked into a single provider's memory.
What you can do with it
- 1Sync identity across AI toolsProvide your personal values and skills to any MCP client by connecting the manoma server.
- 2Maintain version controlled identityTrack every change made to your personal profile using standard git workflows.
- 3Initialize a new identity fileCreate a new soul.md file and use an AI interview to populate your initial profile.
Written from the project's README. Every use case is checked against a quote from it.
How to install manoma MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall manoma MCP in Claude Code
$ claude mcp add manoma -- npx -y manoma-mcpInstall manoma MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"manoma": {
"command": "npx",
"args": [
"-y",
"manoma-mcp"
]
}
}
}Install manoma MCP in VS Code
.vscode/mcp.json
{
"servers": {
"manoma": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"manoma-mcp"
]
}
}
}Install manoma MCP in VS Code CLI
$ code --add-mcp '{"name":"manoma","type":"stdio","command":"npx","args":["-y","manoma-mcp"]}'Install manoma MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"manoma": {
"command": "npx",
"args": [
"-y",
"manoma-mcp"
]
}
}
}Install manoma MCP in Codex
$ codex mcp add manoma -- npx -y manoma-mcpInstall manoma MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.manoma] command = "npx" args = ["-y", "manoma-mcp"]
Install manoma MCP in Gemini CLI
$ gemini mcp add -s user manoma npx -- -y manoma-mcpInstall manoma MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"manoma": {
"command": "npx",
"args": [
"-y",
"manoma-mcp"
]
}
}
}Configuration
SOUL_MD_PATHPath to your soul.md file. Defaults to ~/soul.md if not set.
| Name | Description | |
|---|---|---|
| SOUL_MD_PATH | Path to your soul.md file. Defaults to ~/soul.md if not set. |
Automated checks
Ran Nov 14, 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 reachablepaperdavid/manoma is public and reachablegithub.com/paperdavid/manoma ↗Pass
- Package names this repository as its sourcemanoma-mcp names paperdavid/manoma as sourcenpmjs.com/package/manoma-mcp ↗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-09-12github.com/paperdavid/manoma ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from manoma-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies 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 GitHubsoul.md
Your identity, not theirs. One plain-text file that tells every AI who you are — and that you own.
soul.md is an open format for your AI identity: values, voice, skills, current focus. It lives on your machine, versions in git, and gets compiled into the tools you use. Manoma is the CLI and MCP server that make it work.
npx manoma init # create your soul.md
npx manoma interview # let an AI you already use write it with you
npx manoma compile # wire it into Claude Code — every session knows you
Two more commands close the loop with your AI's own memory:
npx manoma refresh # the AI that's been learning about you proposes updates
# to your file — your approval required, never silent
npx manoma remember # save your soul.md INTO the AI's memory, so even plain
# chats with zero setup know you
Their memory collects; your file is the owned, current copy.
- User-owned — a file on your machine. No cloud, no account, no vendor.
- Works everywhere — compiled into tool configs, pasted into instruction fields, readable by anything.
- Stays alive — add the MCP server and the AI records decisions and lessons into the file as you work, dated and signed; every change is a git diff.
The format
The specification is one page and public domain (CC0): eight plain-markdown sections, a deterministic grammar, and one invariant — a soul.md must stay useful pasted raw into any prompt. Every file written for the older v1.4 format keeps working (migration guide).
The conformance corpus defines correct parsing; a reader that reproduces its expected outputs is conformant. Parallel implementations are welcome — a Python or Rust parser that passes the corpus is a first-class citizen.
The MCP server
{
"mcpServers": {
"manoma": { "command": "npx", "args": ["-y", "manoma-mcp"] }
}
}
One block in Claude Desktop, Cursor, or any MCP client. Six tools: get_context, get_skill_depth, list_sections, and the write-back trio add_decision / add_lesson / update_now — provenance-stamped, sanitized, disclosed. Details in mcp/README.md.
Repo
manoma/
├── mcp/ — the MCP server + manoma CLI (npm: manoma-mcp, manoma)
├── cli/ — the `manoma` npm name (forwards to manoma-mcp)
├── conformance/ — the normative parsing corpus
├── docs/ — migration guide, archived v1.4 spec
├── templates/ — v1.4-era example files (valid, being modernized)
├── SPEC.md — the format specification (CC0)
└── LICENSE — MIT (code)
Philosophy
Every AI vendor keeps its own memory of you, in its own cloud. soul.md is the opposite bet: your identity as a plain file you control, portable between tools, diff-able in git, built to outlive any individual model.
The schema is the thing. The runtime is just how it's read.
Feedback, forks, and parallel implementations welcome — issues. MIT / CC0.
manoma MCP questions
How do I add manoma MCP to Claude Code?
Run claude mcp add manoma -- npx -y manoma-mcp in your terminal. Add --scope user to make it available in every project.
How do I add manoma MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What is soul.md?
It is an open format for your AI identity, including your values, voice, skills, and current focus, stored in a single plain-text file.
Is my data stored in the cloud?
No, the system is user-owned and lives on your machine as a file, meaning there is no cloud, account, or vendor involvement.