Opendock MCP Server
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.
[email protected]
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": "[email protected]",
"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:
[email protected] 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