TrueConf Server MCP

Manage TrueConf Server conferences, recordings, and invitations from any MCP client, including LM Studio, Cursor, Claude Desktop, and others.

English / Русский

Introduction

Model Context Protocol (MCP) is an open standard that allows large language models (LLMs) to invoke external tools through a unified protocol. Without MCP, every LLM client would require a separate TrueConf Server API integration. With MCP, a single server exposes all tools, and any compatible MCP client can immediately use them to create conferences, manage invitations, and access recordings.

TrueConf Server MCP is an intermediary between an LLM client and TrueConf Server. It provides 35 tools for working with conferences, recordings, invitations, participants, calendars, notifications, translations, and AI Server transcriptions.

Server capabilities

Quick start

1. Install the MCP server. → Step 1
2. Create an OAuth application on TrueConf Server. → Step 2
3. Start the MCP server. → Step 3
4. Sign in and obtain a token. → Step 4
5. Connect an MCP client such as LM Studio or Cursor. → Step 5
6. Verify the connection. → Step 6

Step 1 — Installation

pip install trueconf-server-mcp

Step 2 — Create an OAuth application

The MCP server requires the client_id and client_secret of an OAuth application configured on TrueConf Server.

1. Open the TrueConf Server control panel and go to Web → Security → OAuth 2.0. For details, see the documentation.

2. Create an application and specify the following redirect_uri:

   http://localhost:8080/auth/callback
   

3. When creating the application, in the Grant types subsection, select both authorization methods required by the server:

   Grant type	Purpose
   authorization_code	Lets the user sign in through the TrueConf Server web interface
   refresh_token	Lets the MCP server renew an expired token (access tokens live 1 hour by default)

4. Enable the scopes required by the tools:

   Scope	Description
   conferences:read	Read conferences, deep links, shared links, calendars, and translations
   conferences:write	Create, edit, delete, start, stop, join, invite, notify, and register conferences
   conferences.invitations:read	Read invitations
   conferences.invitations:write	Add, edit, and delete invitations
   conferences.participants:read	Read conference participants
   conferences.records:read	Read recordings
   conferences.records:write	Start, stop, and pause recordings
   conferences.restrictions:read	Calculate conference restrictions (calculate_conferences)

5. Copy the client_id and client_secret. You will need them in the next step.

Step 3 — Start the server

trueconf-server-mcp \
  --no-tls --port 8080 \
  --server 10.0.0.1 \
  --client-id <client_id> \
  --client-secret <client_secret>

Where:

• --server is the IP address or domain name of TrueConf Server.
• --client-id and --client-secret are the OAuth application credentials from step 2.
• --no-tls --port 8080 starts the server without TLS on port 8080 for initial setup and testing.

Step 4 — Authentication

1. Open http://localhost:8080/ in your browser. Click Sign in to open the TrueConf Server authentication page.

   

2. Enter your TrueConf Server credentials and grant access.

3. After successful authentication, you will be redirected to /success, which displays your token and ready-to-use MCP client configurations.

   

4. Copy the token. You will need it to connect your MCP client.

Step 5 — Connect an MCP client

Copy the configuration for your client from the /success page or create it manually. Example for LM Studio:

{
  "mcpServers": {
    "trueconf": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <your_token>"
      }
    }
  }
}

Ready-to-use configurations for Cursor, Claude Desktop, OpenCode, and OpenWebUI are available in MCP clients.

Step 6 — Verify the connection

Open your LLM client and ask:

Show my scheduled conferences

The LLM will invoke the list_conferences tool and return your conference list from TrueConf Server.

Configuration

Configuration precedence

Settings are applied in the following order, from highest to lowest priority:

1. CLI options — --server, --port, --no-tls, etc.
2. Environment variables — TRUECONF_SERVER, TRUECONF_MCP_PORT, etc.
3. The .env file — loaded with python-dotenv
4. Defaults — built-in values

Options

Command-line help

trueconf-server-mcp --help

The .env file

Instead of passing configuration through CLI options, you can create a .env file in the working directory. See .env.example:

TRUECONF_SERVER=10.0.0.1
TRUECONF_CLIENT_ID=your_client_id
TRUECONF_SECRET=your_client_secret
TRUECONF_VERIFY_SSL=false
MCP_BASE_URL=http://localhost:8080
MCP_NO_TLS=true
TRUECONF_MCP_PORT=8080

trueconf-server-mcp

TLS for production

By default, when --no-tls is not specified, the server listens on https://0.0.0.0:443 using an automatically generated self-signed certificate. On macOS, the certificate is stored in ~/Library/Application Support/fastmcp/tls/ and reused across restarts.

Custom certificate

To use a trusted certificate, such as one issued by Let's Encrypt:

trueconf-server-mcp \
  --server 10.0.0.1 \
  --client-id <client_id> \
  --client-secret <client_secret> \
  --tls-cert /path/to/cert.pem \
  --tls-key /path/to/key.pem

LM Studio with a self-signed certificate

LM Studio is based on Node.js and does not trust self-signed certificates. If the following error occurs while connecting:

TypeError: fetch failed: self-signed certificate

Start LM Studio with TLS validation disabled:

NODE_TLS_REJECT_UNAUTHORIZED=0 open "/Applications/LM Studio.app"

set NODE_TLS_REJECT_UNAUTHORIZED=0
start "" "C:\Program Files\LM Studio\LM Studio.exe"

NODE_TLS_REJECT_UNAUTHORIZED=0 lm-studio

MCP_BASE_URL

MCP_BASE_URL defines the URL MCP clients use to reach the server. It is included in OAuth metadata and must be externally reachable by your clients.

MCP clients

The server is compatible with any MCP client that supports HTTP transport with bearer authentication. Ready-to-use configurations are available on the /success page after authentication.

LM Studio

{
  "mcpServers": {
    "trueconf": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <your_token>"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "trueconf": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <your_token>"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "trueconf": {
      "type": "http",
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <your_token>"
      }
    }
  }
}

OpenCode

{
  "mcp": {
    "servers": {
      "trueconf": {
        "url": "http://localhost:8080/mcp",
        "transport": "http",
        "headers": {
          "Authorization": "Bearer <your_token>"
        }
      }
    }
  }
}

OpenWebUI

URL:       http://localhost:8080/mcp
Header:    Authorization: Bearer <your_token>

Tool discovery modes

The --discovery-mode option controls how the MCP client sees the server tools:

trueconf-server-mcp --discovery-mode bm25 --server ... --client-id ... --client-secret ...

Troubleshooting

If the problem persists, contact TrueConf technical support.

Links

• TrueConf Server API documentation
• Model Context Protocol
• TrueConf technical support