DollhouseMCP/mcp-server

**Open-source AI customization through modular elements.**
Website · Browse the Collection · NPM Package · Discord
---
How It Works
**Pick any path to start:**
- **Activate** a starter element from your portfolio — your AI immediately changes
- **Create** any element type (persona, skill, template, agent, memory, ensemble) by describing what you want in plain English
- **Edit** any existing element to refine it
- **Browse** the community collection and install elements made by other users
Your **portfolio** (~/.dollhouse/portfolio/ on macOS/Linux, %USERPROFILE%\.dollhouse\portfolio\ on Windows) is a local folder that holds all your Dollhouse elements. It ships with 37 starters — including the **dollhouse-expert-suite** ensemble (persona + knowledge base) you can activate for guided help. Everything you create or install lands here. Share back to the community or sync to GitHub whenever you're ready.
---
Quick Start
> **v2.0.0 is now available.** DollhouseMCP v2 is the default release. Release notes | Migration guide | Report issues
DollhouseMCP installs on any MCP-compatible AI client — Claude Code, Claude Desktop, Cursor, Gemini, Codex, and local LLMs. Core element management (create, activate, search, browse) works across all platforms. Advanced features (Gatekeeper confirmation flows, agentic loop execution) have been tested extensively on Claude Code and should work on any client that supports standard MCP tool call/response patterns.
**Interactive Setup** (any platform):
Opens a browser-based setup wizard with one-click install for Claude Desktop, Claude Code, Cursor, VS Code, Codex, Gemini CLI, Windsurf, Cline, and LM Studio. Detects existing installations, supports auto-updating and pinned versions.
**Permission hook support** in the setup wizard currently breaks down like this:
| Platform | Setup status | Permission hook status |
| --- | --- | --- |
| Claude Code | One-click install | Full native support |
| Cursor | One-click install | Partial native support |
| VS Code | One-click install | Partial native support |
| Codex | One-click install | Partial native support, Bash-only |
| Gemini CLI | One-click install | Partial native support |
| Windsurf | One-click install | Partial native support |
| Cline | One-click install | MCP setup only in this release |
| LM Studio | One-click install | MCP setup only in this release |
| Claude Desktop | One-click install | No native permission hook path in this release |
**Claude Code** (one command):
**Claude Desktop** (one-click install):
Download the DollhouseMCP Desktop Extension (.mcpb file) and double-click it. Claude Desktop handles the rest — no terminal required.
**Other platforms** — see the Quick Start Guide or run the interactive setup above.
Then start a conversation:
DollhouseMCP ships with 38 Dollhouse elements across all 6 types. Just describe what you want in natural language.
> **First time?** The Public Beta Onboarding Guide walks you from install to your first activated Dollhouse persona in under 10 minutes.
---
Dollhouse Elements: Behavior, Capabilities, and Permissions
Dollhouse elements are modular building blocks that customize your AI. When you activate a Dollhouse element, you're not just changing a prompt — you're changing what tools the AI can access, what commands it can run, and what operations require your approval.
| Dollhouse Element | What It Does |
|---|---|
| **Dollhouse Personas** | Shape behavior, tone, expertise, and priorities. Act as security principals with permission policies that control what the AI can do. |
| **Dollhouse Skills*** | Add discrete capabilities the AI can activate on demand. Code review, data analysis, penetration testing, translation, and more. |
| **Dollhouse Templates** | Standardize outputs with variable substitution. Reports, emails, briefs, documentation — consistent structure every time. Variables are auto-derived from {{placeholder}} tokens in content — no manual schema needed. |
| **Dollhouse Agents** | Execute multi-step goals autonomously. State tracking, resilience policies, autonomy evaluation, and an execution lifecycle. |
| **Dollhouse Memories** | Persist structured context across sessions. Facts, preferences, project state. Can auto-load on startup. |