MIDAS MCP Server MIDAS MCP Server: Installation and Setup

Step 1: Install and Enable the MIDAS MCP Server addon

The MIDAS MCP Server is available as an optional add-on for MIDAS v4.43 (or later) and can be purchased from the outset, or added to an existing system at a later stage.

  • To get MIDAS together with the MCP Server add-on, please visit mid.as/pricing.
  • To add the MCP Server add-on to an existing MIDAS booking system, sign in as an administrator and go to MIDAS Admin Options → Addons → Available Addons → MCP Server.

Once the MCP Server add-on is installed, you can configure it via MIDAS Admin Options → Addons, and select MCP Server.

Upon first access, you'll be prompted to enter your MCP Key to activate the addon. This initial key can be found in the email you received when you purchased the MCP Server add-on. The MCP Key acts as a password, and must be kept confidential. Anyone with this key, and access to your MIDAS URL, will be able to use the MIDAS MCP Server according to the permissions you have configured. You can change this key at any time.

Next, tick Enable MCP Server followed by Save Changes to enable the MIDAS MCP server.

You can also decide whether the MCP Server should be able to make changes to MIDAS, or whether it should be restricted to read-only access. Read-only mode is a good starting point if you simply want to test enquiries and availability checks before allowing an AI assistant to make changes on your behalf.

Optionally, you can also restrict access to specific IP addresses if your AI platform connects from a known, fixed address.

For more information on the available settings, please see MCP Server settings.

Once enabled, your MIDAS MCP Server will be available at a URL similar to: 

https://your-midas-url/mcp.pl

Replace your-midas-url with your actual MIDAS domain throughout this page.

Step 2: Connect your AI assistant

Choose your AI platform below for specific setup instructions. In each case, you will need your MIDAS MCP Server URL and your MCP Key from Step 1.

Claude Desktop

Claude Desktop connects to remote MCP servers such as MIDAS using a small bridging tool called mcp-remote. This requires Node.js to be installed on your computer (see Prerequisites).

  1. Open Claude Desktop, and go to Settings > Developer > Edit Config.
  2. This will open, or create, a file named claude_desktop_config.json.
  3. Add the following, replacing the URL and key with your own details:
{
  "mcpServers": {
	"MIDAS": {
		"command": "npx",
		"args": [
			"--node-options=--use-system-ca",
			"mcp-remote@latest",
			"https://your-midas-url/mcp.pl",
			"--header",
			"X-MCP-Key: your-midas-mcp-key"
		]
	}
  }
}
  1. Save the file, and fully restart Claude Desktop.
  2. Start a new conversation, and check for a small tools/plug icon indicating that the MIDAS MCP Server has connected successfully.

Claude.ai (web) and Claude for Work

  1. Go to Settings > Connectors in Claude.ai.
  2. Select Add custom connector.
  3. Enter your MIDAS MCP Server URL: https://your-midas-url/mcp.pl
  4. Where prompted for authentication, choose a custom header, and enter:
X-MCP-Key: your-midas-mcp-key
  1. Save the connector, then enable it from within a conversation using the tools menu.

ChatGPT

Requires a Plus, Pro, Team, Enterprise, or Edu account, with Developer Mode enabled.

  1. In ChatGPT, go to Settings > Connectors (or Apps & Connectors).
  2. Enable Developer Mode under Advanced settings, if not already enabled.
  3. Select Create, and choose the option to add a custom MCP server.
  4. Enter a name, such as "MIDAS", and the MCP Server URL: https://your-midas-url/mcp.pl
  5. For authentication, choose Custom header, and enter:
X-MCP-Key: your-midas-mcp-key
  1. Save the connector.
  2. In a new chat, enable Developer Mode, then add the MIDAS connector as a source before making a request.

Google Gemini CLI

Requires Node.js to be installed (see Prerequisites).

  1. Open (or create) your Gemini CLI settings file, normally at ~/.gemini/settings.json.
  2. Add the following, replacing the URL and key with your own details:
{
  "mcpServers": {
	"MIDAS": {
		"httpUrl": "https://your-midas-url/mcp.pl",
		"headers": {
			"X-MCP-Key": "your-midas-mcp-key"
		}
	}
  }
}
  1. Save the file, and restart Gemini CLI.
  2. Type /mcp within Gemini CLI to confirm that the MIDAS server has connected, and to see the available tools.

Other MCP-compatible platforms

Most other MCP clients follow a similar pattern: a server URL, and a custom HTTP header for authentication. Where prompted for connection details, use:

  • Server URL: https://your-midas-url/mcp.pl
  • Header name: X-MCP-Key
  • Header value: your-midas-mcp-key

If your platform only supports launching local command-line tools rather than connecting to a remote URL directly, you can normally still connect it using mcp-remote in the same way as the Claude Desktop example above.

Testing your connection

Once connected, try a simple, read-only request first, such as asking your AI assistant to check the availability of one of your rooms on a specific date. If this works, the connection has been configured correctly. If you have enabled write access, you can then try asking it to add a test booking.

If the connection fails, double-check the URL, MCP key, and that the MIDAS MCP Server addon is enabled. See the Server Tools page for the full list of actions available once connected, or head over to the Troubleshooting page if you run into any issues.