Talos CLI (talcli)

Overview

talcli is a Go-based CLI tool that gives you full access to the Talos platform from the terminal. It exposes 120+ MCP tools that let any LLM (Claude, GPT, etc.) query your ERP data, send emails, browse files, manage leads, and run operations — all through natural language.

When used as an MCP server, talcli turns Claude Desktop (or any MCP-compatible AI) into your company's AI assistant — with full access to orders, materials, invoices, suppliers, quality data, and more.

Installation

Homebrew (recommended)

Install via Homebrew on macOS or Linux:

brew tap kivanccakmak/talos
brew install talcli

Direct download

Download the pre-built binary for your platform from the Downloads page, extract, and move to your PATH:

# macOS (Apple Silicon)
curl -L https://github.com/kivanccakmak/talcli/releases/latest/download/talcli_darwin-arm64.tar.gz | tar xz
sudo mv talcli /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/kivanccakmak/talcli/releases/latest/download/talcli_darwin-amd64.tar.gz | tar xz
sudo mv talcli /usr/local/bin/

# Windows (x86_64) — download .zip from Downloads page
# Extract talcli.exe and add to PATH

# Linux (x86_64)
curl -L https://github.com/kivanccakmak/talcli/releases/latest/download/talcli_linux-amd64.tar.gz | tar xz
sudo mv talcli /usr/local/bin/

# Linux (ARM64)
curl -L https://github.com/kivanccakmak/talcli/releases/latest/download/talcli_linux-arm64.tar.gz | tar xz
sudo mv talcli /usr/local/bin/

Verify installation:

talcli version

Authentication

Log in with your Talos credentials (same email/password as the web dashboard):

# Interactive (prompts for password)
talcli login -e user@company.com

# Non-interactive (for scripts/agents)
talcli login -e user@company.com -p yourpassword

Your token is stored at ~/.config/talcli/config.json and used for all subsequent commands.

MCP Server — Claude Desktop Setup

The MCP (Model Context Protocol) server is the primary way to use talcli with AI. It exposes all Talos tools as MCP tools that Claude Desktop can call directly.

Step 1 — Install talcli

Follow the installation instructions above. Make sure talcli is in your PATH.

Step 2 — Log in

Run talcli login to authenticate. The MCP server uses your stored credentials.

talcli login -e user@company.com

Step 3 — Configure Claude Desktop

Add the following to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "talos": {
      "command": "talcli",
      "args": ["mcp", "serve"]
    }
  }
}

Step 4 — Restart Claude Desktop

Restart Claude Desktop. You should see "talos" in the MCP servers list. Claude now has access to 120+ Talos tools.

You can verify by asking Claude: "What Talos tools do you have access to?"

What you can do with Claude Desktop + Talos

Once connected, you can ask Claude to do anything with your company data:

Available MCP Tools (120+)

talcli exposes tools across every area of the Talos platform:

CLI Commands

talcli also works as a traditional CLI tool. Run talcli examples to see all available commands:

talcli mat list          # List materials
talcli so list           # List sales orders
talcli inv list          # List invoices
talcli erp sync          # Trigger ERP sync
talcli erp status        # Check sync status
talcli acc search ACME   # Search accounts
talcli emp list          # List employees
talcli recipes get R001  # Get recipe details
talcli mcp serve         # Start MCP server

Using with Claude Code

talcli also works with Claude Code (the CLI version of Claude). Add to your settings:

~/.claude.json or .claude/settings.json

{
  "mcpServers": {
    "talos": {
      "command": "talcli",
      "args": ["mcp", "serve"]
    }
  }
}

Troubleshooting