DollhouseMCP — Claude Code MCP server: features and setup
DollhouseMCP lets you create and activate personas, skills, templates, agents, and memories to shape how an AI works on your project.
claude mcp add mcp-server -- npx -y @dollhousemcp/mcp-serverWhat DollhouseMCP does
DollhouseMCP keeps these elements in a local portfolio: ~/.dollhouse/portfolio/ on macOS and Linux, or %USERPROFILE%\.dollhouse\portfolio\ on Windows. Describe an element in plain language to create it, edit one already there, or activate it. Active elements can change the AI’s behavior and add capabilities or permission policies.
For Claude Code, run the command in the FAQ. The server starts through npx using the @dollhousemcp/mcp-server package. You can also launch a browser setup wizard with npx @dollhousemcp/mcp-server@latest --web. Permission hooks vary by client: Cursor has partial native support, while Cline is limited to MCP setup in this release. That difference matters if your setup depends on permission hooks.
What it helps with
- create a persona for a project workflow
- add project-specific instructions as a skill
- activate an existing agent or ensemble
- revise a saved template
- browse and install community elements
Example prompts for the agent
- Create a skill for checking changes in this project.
- Show me the available Dollhouse personas and activate one for debugging.
- Update the code review persona to include a security check.
How to install DollhouseMCP
Platform CLI
claude mcp add mcp-server -- npx -y @dollhousemcp/mcp-serverPlatform CLI
codex mcp add dollhousemcp -- npx -y @dollhousemcp/mcp-serverConfig file
{
"mcpServers": {
"dollhousemcp": {
"command": "npx",
"args": [
"-y",
"@dollhousemcp/mcp-server"
]
}
}
}Config file
{
"servers": {
"dollhousemcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dollhousemcp/mcp-server"
]
}
}
}Platform CLI
gemini mcp add dollhousemcp npx -y @dollhousemcp/mcp-serverStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about DollhouseMCP
How do I install DollhouseMCP in Claude Code?
Run claude mcp add dollhousemcp -- npx -y @dollhousemcp/mcp-server. This adds the server for your user account.
What does DollhouseMCP do?
It provides tools to create, edit, and activate personas, skills, templates, agents, memories, and ensembles. These elements live in a local portfolio.
Where does DollhouseMCP store its elements?
On macOS and Linux, the portfolio is ~/.dollhouse/portfolio/; on Windows, it is %USERPROFILE%\.dollhouse\portfolio\.
