Control your entire Assistable account by chatting with Claude

Method used: Official assistableai Python package (local MCP server via FastMCP) Platform: Windows & macOS · Claude Desktop Setup time: ~10 minutes · No coding required

What this is

This connects Claude Desktop directly to your Assistable account using Assistable's official Python connector (assistableai[mcp]). Once connected, Claude can read and manage everything in your account assistants, tools, calls, contacts, monitor rules through plain conversation.

Instead of clicking through the Assistable dashboard, you just tell Claude what you want, and it does it for real, live, in your account.

What it actually does

Once connected, from a single Claude chat you can:

…and much more — contacts, appointments, knowledge bases, call logs, tags, and conversations are all controllable through chat.

Why it's so helpful

• No memorizing the dashboard — just describe what you want in normal words

• Built-in audit trail — your chat history records every change made

• Onboard clients in minutes — repeat setups become one prompt

• Diagnose issues without logging in — pull call logs and sentiment from chat

What you need before starting

• Claude Desktop installed

• Python (Step 1 covers it)

• Your Assistable API Key + Subaccount ID (Step 3 covers it)

Step 1 — Install Python

Windows

1. Go to python.org/downloads

2. Click Download Python

3. Run the installer

4. ⚠️ Tick "Add Python to PATH" on the first screen — critical

5. Click Install Now

Check it worked: open PowerShell (search it in Start menu), type:

python --version

macOS

Mac already has a basic Python, but it's best to install the latest:

1. Go to python.org/downloads → Download → run the .pkg installer, or

2. If you use Homebrew, open Terminal and run:

brew install python

Check it worked: open Terminal (search "Terminal" in Spotlight), type:

python3 --version

On Mac, you type python3 instead of python everywhere in this guide.

Step 2 — Install the Assistable connector

Windows — in PowerShell:

pip install "assistableai[mcp]"

macOS — in Terminal:

pip3 install "assistableai[mcp]"

Let it finish. When you can type again, it's done.

Step 3 — Get your API Key & Subaccount ID

In app.assistable.ai (same on both platforms):

• API Key → Settings → Integrations → API Keys → Generate Key (starts with ask_live_...)

• Subaccount ID → Settings → Account (long string like 1753298396627x629...)

⚠️ Keep your API key private. Anyone with it controls your whole account. Never share it in screenshots or logs.

Step 4 — Open the correct config file

Try this first (both platforms): Claude Desktop → Settings → Developer → Edit Config If that button exists, it opens the right file. Skip to Step 5.

If it's not there, open the file manually:

Windows

Most installs (Microsoft Store version) hide it here. Paste into PowerShell:

explorer "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\"

Find claude_desktop_config.json and open with Notepad. If missing, create it.

#1 Windows mistake: editing the file in AppData\Roaming\Claude. The Store version ignores that folder — it must be the Packages\Claude_... path above.

macOS

Open Terminal and paste:

open ~/Library/Application\ Support/Claude/

Find claude_desktop_config.json and open with TextEdit. If missing, create it.

Full path for reference:

~/Library/Application Support/Claude/claude_desktop_config.json

Step 5 — Paste in your config

Paste this in, replacing the two placeholders:

Windows

{
  "mcpServers": {
    "assistableai": {
      "command": "python",
      "args": ["-m", "assistableai.mcp"],
      "env": {
        "ASSISTABLE_API_KEY": "YOUR_API_KEY_HERE",
        "ASSISTABLE_SUBACCOUNT_ID": "YOUR_SUBACCOUNT_ID_HERE"
      }
    }
  }
}

macOS

Note python3 instead of python:

{
  "mcpServers": {
    "assistableai": {
      "command": "python3",
      "args": ["-m", "assistableai.mcp"],
      "env": {
        "ASSISTABLE_API_KEY": "YOUR_API_KEY_HERE",
        "ASSISTABLE_SUBACCOUNT_ID": "YOUR_SUBACCOUNT_ID_HERE"
      }
    }
  }
}

Save and close.

Paste it into jsonlint.com first to catch typos — one missing comma breaks it.

Step 6 — Fully restart Claude

Closing the window isn't enough — Claude keeps running in the background.

Windows — in PowerShell:

taskkill /F /IM claude.exe

macOS — press Cmd + Q to fully quit, or in Terminal:

killall Claude

Then reopen Claude Desktop and start a new conversation.

Step 7 — Test it

Type:

List all my assistants

If your bots appear — you're connected.

Then try:

Give me a health report of my subaccount
Create a booking bot for a dental clinic

Troubleshooting

The 2 things that trip everyone up

1. You never run the connector yourself. Claude launches it automatically. Typing the run command by hand just freezes — that's normal.

2. Use the right config file + right Python command. Windows = python + Packages\Claude_... folder. Mac = python3 + Library/Application Support/Claude.

Verify it's truly working (optional)

Windows — in PowerShell:

type "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\logs\mcp-server-assistableai.log"

macOS — in Terminal:

cat ~/Library/Logs/Claude/mcp-server-assistableai.log

If you see "Server started and connected successfully" plus a list of tools — it's fully working.