TakeSix

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/mcp works with any agent that supports the Model Context Protocol. It runs on your computer through npx; 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:

Terminal
claude mcp add --scope user takesix -- npx -y @takesix/mcp

Without --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:

Terminal
git clone https://github.com/vvapnik/takesix-agent
cp -R takesix-agent/skill/takesix ~/.claude/skills/takesix

Claude picks the skill up when you ask for an overview of something structured, or for a TakeSix diagram by name.

Claude Desktop

  1. Open Settings → Developer → Edit Config. This opens claude_desktop_config.json.
  2. Add takesix to mcpServers (keep the servers that are already there):
claude_desktop_config.json
{
  "mcpServers": {
    "takesix": {
      "command": "npx",
      "args": ["-y", "@takesix/mcp"]
    }
  }
}
  1. 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

Terminal
codex mcp add takesix -- npx -y @takesix/mcp

Or add it by hand to ~/.codex/config.toml. The longer start-up timeout gives npx time to download the package the first time:

~/.codex/config.toml
[mcp_servers.takesix]
command = "npx"
args = ["-y", "@takesix/mcp"]
startup_timeout_sec = 30

Check with codex mcp list.

Cursor

Add the server to ~/.cursor/mcp.json for all projects, or to .cursor/mcp.json in one project:

mcp.json
{
  "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:

.vscode/mcp.json
{
  "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.
Command
npx -y @takesix/mcp

claude.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:

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; run npx -y @takesix/mcp once 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 with npm install -g @takesix/mcp and use takesix-mcp as the command, without npx.
Windows: “npx is not recognized” or the server never connects
Some clients cannot run npx directly 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.