Skip to main content

LibreChat with VMCP

This guide walks you through connecting LibreChat (self-hosted AI chat platform) to your Virtual MCP (VMCP) servers through MintMCP.

Prerequisites​

Before starting, ensure you have:

  • LibreChat instance running (Docker or standalone)
  • Admin access to LibreChat configuration files
  • A MintMCP account with at least one configured VMCP

Step 1: Get Your VMCP Connection URL​

  1. Navigate to your VMCP in the MintMCP dashboard
  2. Click on the VMCP you want to connect
  3. Navigate to the "MCP Client Setup" tab
  4. Copy the MCP URL displayed
VMCP URL in MintMCP dashboard

Step 2: Configure LibreChat​

Edit librechat.yaml​

  1. Add your MintMCP VMCP to the librechat.yaml file:
mcpServers:
  google-workspace:
    type: streamable-http
    url: https://app.mintmcp.com/s/g_1mzSpaVTho0OHy5BE1pkNF/mcp
    timeout: 60000

Replace url with the MCP URL from Step 1.

For Docker Installation​

  1. Ensure the configuration file is mounted in your docker-compose.yml:
services:
  api:
    volumes:
      - ./librechat.yaml:/app/librechat.yaml:ro
      # ... Other configs here

Step 3: Restart LibreChat​

After editing the configuration:

# For Docker
docker-compose restart

# For standalone installation
# Restart your LibreChat service

Step 4: Authenticate and Connect​

  1. Open LibreChat in your browser
  2. Start a new chat
  3. Look for the MCP dropdown below your text input
  4. Select your MintMCP VMCP from the dropdown
MCP server dropdown in LibreChat
  1. Complete the MintMCP OAuth authentication flow MCP server dropdown in LibreChat
  2. A green info popup will show that the MCP has been connected

Step 5: Test the Connection​

  1. With your VMCP selected, test it by asking: 
    What emails have I received today?
  2. LibreChat will use the MCP server to access your VMCP tools
  3. Verify the response matches your expectations