Installation

Prerequisites

• Node.js 24 or later. Use nvm or fnm if you need to manage multiple Node versions.
• A Toptal Talent account that you control. TTCtl is a personal-productivity tool against your own profile only.
• The 1Password CLI (op) if you plan to use the recommended op://vault/item auth form. Install it from 1Password’s downloads page and enable Desktop App integration for biometric auth.

Install with npm

Global install:

npm install -g ttctl

Or run on demand without installing globally:

npx ttctl --help

MCP integration

TTCtl implements the Model Context Protocol (MCP), exposing its capabilities to AI assistants through ttctl mcp. The configuration snippets below mirror the QontoCtl MCP integration patterns and apply to TTCtl with the binary name ttctl.

Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
    "mcpServers": {
        "ttctl": {
            "command": "npx",
            "args": ["ttctl", "mcp"]
        }
    }
}

Claude Code

claude mcp add ttctl -- npx ttctl mcp

Cursor

Add to .cursor/mcp.json in your project root:

{
    "mcpServers": {
        "ttctl": {
            "command": "npx",
            "args": ["ttctl", "mcp"]
        }
    }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
    "mcpServers": {
        "ttctl": {
            "command": "npx",
            "args": ["ttctl", "mcp"]
        }
    }
}

Verify the install

ttctl --help

You should see the top-level command list. If you get command not found, your global npm bin directory is not on PATH; check with npm config get prefix and add the resulting bin/ directory to your shell’s PATH.

Updating

npm install -g ttctl@latest

TTCtl follows semantic versioning. Release notes for each version are published on GitHub Releases.

---

Unofficial. Not affiliated with Toptal LLC. Full disclaimer →