What is Boomi Mcp Server

Boomi MCP Server is a Model Context Protocol (MCP) server designed for interaction with the Boomi API, exposing Boomi SDK operations as MCP tools using FastMCP.

Use cases

Common use cases include automating data workflows, integrating various applications with the Boomi API, and developing custom tools that leverage Boomi’s capabilities.

How to use

To use Boomi MCP Server, you can run it via Docker by pulling the latest image and setting your Boomi credentials as environment variables. Alternatively, you can build it from source and run it with your credentials.

Key features

Key features include support for Python 3.10+, easy setup via Docker, and the ability to expose Boomi SDK operations as MCP tools. It also allows for configuration using environment variables or a .env file.

Where to use

Boomi MCP Server can be used in environments where integration with the Boomi API is required, such as cloud applications, enterprise software solutions, and data integration tasks.

Boomi MCP Server

This repository provides a simple Model Context Protocol (MCP) server for interacting with the Boomi API. The server exposes Boomi SDK operations as MCP tools using FastMCP.

Table of Contents

• Requirements
• Quick start
• Usage
• Running via Docker
• Running from Source
• Cursor/Claude Setup
• Running tests
• Contributing

Requirements

• Python 3.10+
• Access credentials for the Boomi API

Quick start

The recommended way to run the Boomi MCP Server is using Docker:

# Pull the latest image
docker pull ghcr.io/glebuar/boomi-mcp-server:latest

# Run with environment variables
docker run -d --name boomi-mcp-server -p 8080:8080 \
  -e BOOMI_ACCOUNT=your_account \
  -e BOOMI_USER=your_user \
  -e BOOMI_SECRET=your_secret \
  ghcr.io/glebuar/boomi-mcp-server:latest

Alternatively, you can build from source:

git clone https://github.com/glebuar/boomi-mcp-server.git
cd boomi-mcp-server
docker build -t boomi-mcp-server .
docker run -p 8080:8080 --env-file .env boomi-mcp-server

Usage

Set your Boomi credentials using environment variables or a .env file
(copy the provided .env.example and fill in your values):

BOOMI_ACCOUNT=...
BOOMI_USER=...
BOOMI_SECRET=...

If a .env file exists in the working directory the server will load it automatically.

Using the Python client

A Python client is available in the src/boomi_mcp_client directory for programmatic access:

import sys
sys.path.append('src')
from boomi_mcp_client import MCPClient

client = MCPClient("http://localhost:8080")
print(client.list_tools())
result = client.call_tool("health_check")
print(result)

See examples/using_client.py for a complete script
demonstrating these calls.

Running via Docker

Docker is the recommended way to run the Boomi MCP Server for production use:

Using Docker Compose (Recommended)

1. Create a .env file from the example:

   cp .env.example .env
   # Edit .env with your Boomi credentials
   

2. Start the server:

   docker-compose up -d
   

3. Check if server is running:

   docker ps | grep boomi-mcp-server
   

Using Docker directly

# Build the image
docker build -t boomi-mcp-server .

# Run with environment variables
docker run -d \
  --name boomi-mcp-server \
  -p 8080:8080 \
  -e BOOMI_ACCOUNT=your_account \
  -e BOOMI_USER=your_user \
  -e BOOMI_SECRET=your_secret \
  boomi-mcp-server

# Or use an env file
docker run -d \
  --name boomi-mcp-server \
  -p 8080:8080 \
  --env-file .env \
  boomi-mcp-server

Docker Features

• Non-root user: Runs as unprivileged user for security
• Health checks: Built-in health monitoring
• Optimized layers: Efficient caching for faster rebuilds
• Production ready: Includes all necessary runtime dependencies

Running from Source

For development or when you need to run the server locally without Docker:

Prerequisites

• Python 3.10+
• pip or uv package manager

Setup

git clone https://github.com/glebuar/boomi-mcp-server.git
cd boomi-mcp-server

# Create virtual environment
python -m venv .venv
source .venv/bin/activate     # Linux/macOS
# or .venv\Scripts\activate    # Windows

# Install dependencies
pip install -r requirements.txt

Running the server

# stdio mode (for Cursor/Claude Desktop integration)
python -m boomi_mcp_server.server

# SSE mode (HTTP server on port 8080)
python -m boomi_mcp_server.server --transport sse --port 8080

Integration with Claude Desktop

For Claude Desktop integration, add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "boomi": {
      "command": "python",
      "args": [
        "-m",
        "boomi_mcp_server.server"
      ],
      "cwd": "/path/to/boomi-mcp-server",
      "env": {
        "BOOMI_ACCOUNT": "your_account",
        "BOOMI_USER": "your_user",
        "BOOMI_SECRET": "your_secret"
      }
    }
  }
}

Features

The server exposes 85+ tools covering the complete Boomi integration lifecycle:

Core Workflow Support

• Discovery: Query components, environments, atoms, and folders
• Development: Create/update components, manage folders
• Packaging: Create versioned packages for deployment
• Deployment: Deploy packages, check deployment status
• Execution: Run processes with parameters, manage attachments
• Monitoring: Query executions, view logs, track performance
• Debugging: Access detailed logs, artifacts, and error records
• Management: Handle schedules, properties, extensions

Connector Support

• AS2, EDI (X12/EDIFACT), HL7, OFTP2, RosettaNet, Tradacoms
• Query connector records and retrieve artifacts
• Manage connector configurations

Advanced Features

• Process-atom attachments for execution
• Environment-atom attachments
• Queue management and listener control
• Audit logs and system events
• Document rerun capabilities
• Runtime restart management

See docs/cursor_setup.md for instructions on setting up
the server with Cursor/Claude Desktop.

Development

Running tests

To run tests, you’ll need to install development dependencies:

# Clone the repository
git clone https://github.com/glebuar/boomi-mcp-server.git
cd boomi-mcp-server

# Create virtual environment
python -m venv .venv
source .venv/bin/activate

# Install test dependencies
pip install -r requirements.txt
pip install pytest pytest-cov ruff

# Run tests
pytest

# Run linter
ruff check .

Contributing

Please open an issue or pull request if you encounter problems or have
improvements. Ensure pytest and ruff pass before submitting changes.