Guide
Connect TakeSix to your AI agent
Once connected, your agent can answer with a diagram you click into instead of pages of text. It takes one command or a few lines of configuration, and works with Claude Code, Claude Desktop, Codex, Cursor, VS Code and other agents that support MCP.
How it works
There are two ways to connect. Both teach the agent the same rules and check its diagrams.
- MCP server
@takesix/mcpworks with any agent that supports the Model Context Protocol. It runs on your computer throughnpx; nothing is sent anywhere. Needs Node.js 22 or newer. - Agent Skill is a folder of instructions and a script for Claude. Needs only Node.js.
The MCP server gives the agent three tools:
guide: the format and the rules that make a diagram readable. The agent reads it first.validate: checks a diagram and lists each problem with its place in the JSON, so the agent fixes its own answer.show: writes the diagram as one HTML file that opens in any browser, without internet. In apps that support MCP Apps, such as Claude Desktop, the diagram also opens right in the chat.
Claude Code
Add the MCP server for all your projects:
claude mcp add --scope user takesix -- npx -y @takesix/mcpWithout --scope user it is added to the current project only. Check that it is there with claude mcp list, or type /mcp inside Claude Code.
Claude Code shows the answer as text, so the agent gives you the path of the HTML file; open it in your browser.
Or install the skill instead of the server:
git clone https://github.com/vvapnik/takesix-agent
cp -R takesix-agent/skill/takesix ~/.claude/skills/takesixClaude picks the skill up when you ask for an overview of something structured, or for a TakeSix diagram by name.
Claude Desktop
- Open Settings → Developer → Edit Config. This opens
claude_desktop_config.json. - Add
takesixtomcpServers(keep the servers that are already there):
{
"mcpServers": {
"takesix": {
"command": "npx",
"args": ["-y", "@takesix/mcp"]
}
}
}- Quit Claude Desktop completely and start it again.
Claude Desktop supports MCP Apps, so the diagram appears in the conversation, with a button to open it full screen.
Codex
codex mcp add takesix -- npx -y @takesix/mcpOr add it by hand to ~/.codex/config.toml. The longer start-up timeout gives npx time to download the package the first time:
[mcp_servers.takesix]
command = "npx"
args = ["-y", "@takesix/mcp"]
startup_timeout_sec = 30Check with codex mcp list.
Cursor
Add the server to ~/.cursor/mcp.json for all projects, or to .cursor/mcp.json in one project:
{
"mcpServers": {
"takesix": {
"command": "npx",
"args": ["-y", "@takesix/mcp"]
}
}
}Then check that takesix is enabled in Cursor Settings → MCP.
VS Code
GitHub Copilot uses MCP servers in agent mode. Add .vscode/mcp.json to your project. Note that VS Code calls the list servers:
{
"servers": {
"takesix": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@takesix/mcp"]
}
}
}Open Copilot Chat in agent mode; the TakeSix tools appear in its tool list.
Other MCP clients
Most clients take the same mcpServers block as Claude Desktop, only in their own file:
- Windsurf:
~/.codeium/windsurf/mcp_config.json - Gemini CLI:
~/.gemini/settings.json - Others: look for “MCP servers” in the settings and add a stdio server with the command below.
npx -y @takesix/mcpclaude.ai and ChatGPT in the browser
Agents in the browser can only reach MCP servers on the internet, and TakeSix runs on your computer for now. A hosted server is planned. Until then, use Claude Desktop or one of the coding agents above.
How to ask
Ask in plain words and mention TakeSix, at least the first few times:
- “Explain the architecture of this repository as a TakeSix diagram.”
- “Summarize this spec as a TakeSix diagram I can click into.”
- “Show our plan for the quarter as a TakeSix diagram, with ✅ ⏳ ○ for the status of each task.”
- “Compare these three libraries as a TakeSix diagram.”
To get diagrams without asking every time, add a line to your project’s CLAUDE.md or AGENTS.md:
When an answer has structure (architecture, a plan, a comparison, an overview of code or a document), answer with a TakeSix diagram using the takesix MCP server, and keep the text reply short.See what such answers look like: architecture and to-do list.
Troubleshooting
- The server does not start
- Check
node -v: the server needs Node.js 22 or newer. The first start downloads the package, which can take a while on a slow connection; runnpx -y @takesix/mcponce in a terminal to warm the cache. - The client gives up while starting the server
- Raise its start-up timeout (Codex:
startup_timeout_sec), or install the server once withnpm install -g @takesix/mcpand usetakesix-mcpas the command, withoutnpx. - Windows: “npx is not recognized” or the server never connects
- Some clients cannot run
npxdirectly on Windows. Use"command": "cmd"with"args": ["/c", "npx", "-y", "@takesix/mcp"]. - The diagram does not appear in the chat
- Your client does not show MCP Apps. The agent still gives you the path of the HTML file; open it in a browser.
- The agent answers with text anyway
- Ask for a TakeSix diagram by name, or add the line above to
CLAUDE.md/AGENTS.md. To check that the tools are connected, ask: “Which TakeSix tools do you have?”
Building your own app? @takesix/react shows and edits TakeSix diagrams in React; the editor on this site is built with it.