TrueConf Server MCP

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 and chats.

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

Server capabilities

Related MCP server: outlook-mcp

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

Install the application with uv (recommended):

uv tool install trueconf-server-mcp

Or install it with pip:

pip install trueconf-server-mcp

uvx trueconf-server-mcp --server 10.0.0.1 --client-id ... --client-secret ...

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
   IMPORTANT

   The redirect URI must equalMCP_BASE_URL followed by /auth/callback. If you use another host or port, update it accordingly. See MCP_BASE_URL.

3. 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, and join conferences
   conferences.invitations:read	Read invitations
   conferences.invitations:write	Add, edit, delete, and send invitations; send notifications; register users
   conferences.participants:read	Read participants, the conference owner, and the current user
   conferences.records:read	Read recordings
   conferences.records:write	Start, stop, and pause recordings
   conferences.messages:read	Read and export chat messages

4. 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