Opendock

by Pollamin

2 stars
130 downloads
Not rated
GitHub

About

An MCP server that connects AI assistants (Claude, etc.) to the Opendock Neutron API for warehouse dock scheduling and management.

Details

Author
Pollamin
GitHub stars
2
Downloads
130
Categories
Other

- 69 tools across 11 categories (warehouses, docks, appointments, carriers, etc.)
- Connects AI assistants to the Opendock Neutron API
- Supports username/password with automatic token refresh
- Supports pre‑existing JWT token authentication
- Provides appointment metrics and warehouse insights
- Works with Claude Desktop and Claude Code

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Opendock
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via npx -y opendock-mcp or npm install -g opendock-mcp. Set environment variables OPENDOCK_USERNAME and OPENDOCK_PASSWORD (or OPENDOCK_TOKEN for JWT). Add it to Claude Desktop’s claude_desktop_config.json or use claude mcp add opendock -- npx -y opendock-mcp for Claude Code.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "opendock": {
            "opendock": {
                "command": "npx",
                "args": [
                    "-y",
                    "opendock-mcp"
                ],
                "env": {
                    "OPENDOCK_USERNAME": "<YOUR_USERNAME>",
                    "OPENDOCK_PASSWORD": "<YOUR_PASSWORD>"
                }
            }
        }
    }
}

McpServers

{
    "opendock": {
        "command": "npx",
        "args": [
            "-y",
            "opendock-mcp"
        ],
        "env": {
            "OPENDOCK_USERNAME": "<YOUR_USERNAME>",
            "OPENDOCK_PASSWORD": "<YOUR_PASSWORD>"
        }
    }
}

Opendock MCP Server

npm version

An MCP server that connects AI assistants (Claude, etc.) to the legendary Opendock Neutron API.

Install

No clone or build needed — just use npx:

npx -y opendock-mcp

Or install globally:

npm install -g opendock-mcp

Tools

69 tools across 11 categories:

| Category | Tools |
|----------|-------|
| General | get_version, get_profile |
| Warehouses | list_warehouses, get_warehouse, get_warehouse_hours, create_warehouse, update_warehouse, delete_warehouse |
| Docks | list_docks, get_dock, create_dock, update_dock, delete_dock, sort_docks, get_dock_availability |
| Load Types | list_load_types, get_load_type, get_load_type_availability, create_load_type, update_load_type, delete_load_type |
| Appointments | list_appointments, search_appointments, get_appointment, create_appointment, update_appointment, delete_appointment, get_public_appointment, undo_appointment_status, create_recurring_appointments, delete_recurring_appointments, add_appointment_tag, remove_appointment_tag |
| Carriers | list_carriers, get_carrier, create_carrier, update_carrier, get_booked_carriers |
| Companies | list_companies, get_company, create_company |
| Orgs | get_org, update_org, update_favorite_carriers |
| Audit Log | get_audit_log |
| Settings Metadata | get_settings_metadata, get_setting_metadata, validate_settings_metadata |
| Metrics | get_appointment_volume_by_date, get_appointment_volume_by_carrier, get_appointment_volume_by_load_type, get_appointment_volume_by_time_of_day, get_appointment_volume_by_day_of_week, get_appointment_avg_duration_by_load_type, get_appointment_avg_duration_by_status, get_appointment_avg_duration_by_dock_and_status, get_appointment_count_for_carrier, get_appointment_count_by_status_for_carrier, get_appointment_count_for_docks, get_reserve_count_for_user, get_dock_dwell_time, get_carrier_status_percentages, list_appointment_metrics, export_appointment_metrics_excel, get_appointment_status_times, get_first_available_appointment, get_warehouse_insights, get_warehouse_capacity_usage, export_yard_data_excel |

Prerequisites

- Node.js 18+
- An Opendock account with API access

Authentication

The server supports two authentication methods:

Option 1: Username/password (recommended) — the server handles login and token refresh automatically.

OPENDOCK_USERNAME=user@example.com
OPENDOCK_PASSWORD=your-password

Option 2: Pre-existing JWT token

OPENDOCK_TOKEN=your-jwt-token

Optionally set the API URL:

OPENDOCK_API_URL=https://neutron.opendock.com           # production (default)
OPENDOCK_API_URL=https://neutron.staging.opendock.com    # staging

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "opendock": {
      "command": "npx",
      "args": ["-y", "opendock-mcp"],
      "env": {
        "OPENDOCK_USERNAME": "user@example.com",
        "OPENDOCK_PASSWORD": "your-password"
      }
    }
  }
}

Usage with Claude Code

claude mcp add opendock -- npx -y opendock-mcp

Set the required environment variables before launching Claude Code, or pass them in the MCP config.

Testing

Use the MCP Inspector to test interactively:

OPENDOCK_USERNAME=user@example.com OPENDOCK_PASSWORD=your-password \
  npx @modelcontextprotocol/inspector npx -y opendock-mcp

Development

git clone https://github.com/Pollamin/opendock-mcp.git
cd opendock-mcp
npm install
npm run build

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.