Tidio MCP Connector

An MCP (Model Context Protocol) server that connects AI assistants to Tidio live chat - with automatic setup

Features

• Automatic Setup: Connect to Tidio with one command - no manual key copying
• OAuth Authentication: Opens browser for secure Tidio login, auto-retrieves your public key
• Credential Persistence: Credentials are saved locally for future sessions
• Embed Code Generation: Get ready-to-use JavaScript code for any website

Installation

npm install tidio-mcp-connector

Or clone and build locally:

git clone https://github.com/your-username/tidio-mcp-connector.git cd tidio-mcp-connector npm install npm run build

Usage

With Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{ "mcpServers": { "tidio": { "command": "npx", "args": ["tidio-mcp-connector"] } } }

With Lovable

This MCP connector works with Lovable and similar AI-powered development platforms. Add it as a custom MCP server.

With MCP Inspector (Testing)

npx @modelcontextprotocol/inspector npx tidio-mcp-connector

Available Tools

tidio_connect (Recommended)

Connect to Tidio and automatically get your public key.

How it works:

1. Opens your browser to Tidio's login page
2. You authenticate with your Tidio account
3. Returns your public key and embed code automatically

Parameters:

• site_url (required): The website URL where Tidio will be embedded

Example:

Connect Tidio to https://mywebsite.com

tidio_status

Check your connection status and get your embed code.

Parameters: None

tidio_disconnect

Clear stored credentials.

generate_tidio_embed

Generate embed code for a specific public key (if you already have one).

Parameters:

• public_key (required): Your Tidio public key
• loading_mode (optional): "async" (default) or "sync"

How It Works

1. User calls tidio_connect with their website URL
2. Browser opens to Tidio's authentication page
3. User logs in to their Tidio account
4. Callback received - MCP server gets the refresh token
5. API calls made - exchanges token for access token, then retrieves public key
6. Credentials saved to ~/.tidio-mcp/credentials.json
7. Embed code returned - ready to add to the website

Credential Storage

Credentials are stored locally at ~/.tidio-mcp/credentials.json:

{ "public_key": "abc123...", "access_token": "...", "refresh_token": "...", "site_url": "https://example.com", "created_at": "2024-01-01T00:00:00.000Z", "updated_at": "2024-01-01T00:00:00.000Z" }

Embed Code Output

The connector generates optimized async loading code:

Development

Install dependencies

npm install

Run in development mode

npm run dev

Build for production

npm run build

Run built version

npm start

Requirements

• Node.js 18+
• A Tidio account (free tier works)

License

MIT

Related

• Tidio - Live chat and chatbot platform
• Model Context Protocol - Open standard for AI integrations
• Lovable - AI-powered app development