Bullhorn Crm MCP Server By Cdata

🚀 bullhorn-crm-mcp-server-by-cdata

CData's Model Context Protocol (MCP) Server for Bullhorn CRM, enabling LLMs to access live CRM data.

:heavy_exclamation_mark: This project builds a read-only MCP server. For full read, write, update, delete, and action capabilities and a simplified setup, check out our free CData MCP Server for Bullhorn CRM (beta).

🚀 Quick Start

We created this read-only MCP Server to allow LLMs (like Claude Desktop) to query live data Bullhorn CRM supported by the CData JDBC Driver for Bullhorn CRM.

CData JDBC Driver connects to Bullhorn CRM by exposing them as relational SQL models.

This server wraps that driver and makes Bullhorn CRM data available through a simple MCP interface, so LLMs can retrieve live information by asking natural language questions — no SQL required.

✨ Features

• Allows LLMs to query live Bullhorn CRM data.
• Uses CData JDBC Driver to expose CRM data as relational SQL models.
• Provides a simple MCP interface for data retrieval.

📦 Installation

1. Clone the repository:

git clone https://github.com/cdatasoftware/bullhorn-crm-mcp-server-by-cdata.git
cd bullhorn-crm-mcp-server-by-cdata

2. Build the server:

mvn clean install

This creates the JAR file: CDataMCP-jar-with-dependencies.jar 2. Download and install the CData JDBC Driver for {source}: https://www.cdata.com/drivers/bullhorncrm/download/jdbc 3. License the CData JDBC Driver: * Navigate to the lib folder in the installation directory, typically: * (Windows) C:\Program Files\CData\CData JDBC Driver for Bullhorn CRM\ * (Mac/Linux) /Applications/CData JDBC Driver for Bullhorn CRM/ * Run the command java -jar cdata.jdbc.bullhorncrm.jar --license * Enter your name, email, and "TRIAL" (or your license key). 4. Configure your connection to the data source (Salesforce as an example): * Run the command java -jar cdata.jdbc.bullhorncrm.jar to open the Connection String utility. * Configure the connection string and click "Test Connection" > ⚠️ Important Note > > If the data sources uses OAuth, you will need to authenticate in your browser. * Once successful, copy the connection string for use later. 5. Create a .prp file for your JDBC connection (e.g. bullhorn-crm.prp) using the following properties and format: * Prefix - a prefix to be used for the tools exposed * ServerName - a name for your server * ServerVersion - a version for your server * DriverPath - the full path to the JAR file for your JDBC driver * DriverClass - the name of the JDBC Driver Class (e.g. cdata.jdbc.bullhorncrm.BullhornCRMDriver) * JdbcUrl - the JDBC connection string to use with the CData JDBC Driver to connect to your data (copied from above) * Tables - leave blank to access all data, otherwise you can explicitly declare the tables you wish to create access for

Prefix=bullhorncrm
ServerName=CDataBullhornCRM
ServerVersion=1.0
DriverPath=PATH\TO\cdata.jdbc.bullhorncrm.jar
DriverClass=cdata.jdbc.bullhorncrm.BullhornCRMDriver
JdbcUrl=jdbc:bullhorncrm:InitiateOAuth=GETANDREFRESH;
Tables=

💻 Usage Examples

Basic Usage

# Clone the repository
git clone https://github.com/cdatasoftware/bullhorn-crm-mcp-server-by-cdata.git
cd bullhorn-crm-mcp-server-by-cdata

# Build the server
mvn clean install

# Download and install the CData JDBC Driver
# License the driver
# Configure the connection
# Create the .prp file

# Run the server
java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/Salesforce.prp

Advanced Usage

// JSON-RPC request example for getting tables
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "source_get_tables",
        "arguments": {}
    }
}

📚 Documentation

Using the Server with Claude Desktop

1. Create the config file for Claude Desktop ( claude_desktop_config.json) to add the new MCP server, using the format below. If the file already exists, add the entry to the mcpServers in the config file.

Windows

{
    "mcpServers": {
        "{classname_dash}": {
            "command": "PATH\\TO\\java.exe",
            "args": [
                "-jar",
                "PATH\\TO\\CDataMCP-jar-with-dependencies.jar",
                "PATH\\TO\\bullhorn-crm.prp"
            ]
        },
        ...
    }
}

Linux/Mac

{
    "mcpServers": {
        "{classname_dash}": {
            "command": "/PATH/TO/java",
            "args": [
                "-jar",
                "/PATH/TO/CDataMCP-jar-with-dependencies.jar",
                "/PATH/TO/bullhorn-crm.prp"
            ]
        },
        ...
    }
}

If needed, copy the config file to the appropriate directory (Claude Desktop as the example). Windows

cp C:\PATH\TO\claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json

Linux/Mac

cp /PATH/TO/claude_desktop_config.json /Users/{user}/Library/Application\ Support/Claude/claude_desktop_config.json'

2. Run or refresh your client (Claude Desktop).

⚠️ Important Note

You may need to fully exit or quit your Claude Desktop client and re-open it for the MCP Servers to appear.

Running the Server

java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/Salesforce.prp

⚠️ Important Note

The server uses stdio so can only be used with clients that run on the same machine as the server.

Usage Details

Once the MCP Server is configured, the AI client will be able to use the built-in tools to read, write, update, and delete the underlying data. In general, you do not need to call the tools explicitly. Simply ask the client to answer questions about the underlying data system. For example:

• "What is the correlation between my closed won opportunities and the account industry?"
• "How many open tickets do I have in the SUPPORT project?"
• "Can you tell me what calendar events I have today?"

The list of tools available and their descriptions follow:

Tools & Descriptions

In the definitions below, {servername} refers to the name of the MCP Server in the config file (e.g. {classname_dash} above).

• {servername}_get_tables - Retrieves a list of tables available in the data source. Use the {servername}_get_columns tool to list available columns on a table. The output of the tool will be returned in CSV format, with the first line containing column headers.
• {servername}_get_columns - Retrieves a list of columns for a table. Use the {servername}_get_tables tool to get a list of available tables. The output of the tool will be returned in CSV format, with the first line containing column headers.
• {servername}_run_query - Execute a SQL SELECT query

JSON-RPC Request Examples

If you are scripting out the requests sent to the MCP Server instead of using an AI Client (e.g. Claude), then you can refer to the JSON payload examples below – following the JSON-RPC 2.0 specification - when calling the available tools.

source_get_tables

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "source_get_tables",
        "arguments": {}
    }
}

source_get_columns

{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
        "name": "source_get_columns",
        "arguments": {
            "table":  "Account"
        }
    }
}

source_run_query

{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
        "name": "source_run_query",
        "arguments": {
            "sql":  "SELECT * FROM [Account] WHERE [IsDeleted] = true"
        }
    }
}

🔧 Technical Details

The server is built using Java and utilizes the CData JDBC Driver to connect to Bullhorn CRM. It exposes a simple MCP interface that allows LLMs to interact with the CRM data. The server uses stdio for communication, which means it can only be used with clients running on the same machine.

📄 License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

All Supported Sources