JobNimbus MCP Server

Connects Claude directly to your JobNimbus account via the API.

Tools Available

Tool	Description
`jn_list_contacts`	List/search contacts (filter by name, email, status)
`jn_get_contact`	Get a single contact by jnid
`jn_create_contact`	Create a new contact
`jn_update_contact`	Update contact fields + custom fields
`jn_list_jobs`	List/search jobs (filter by status, contact, name)
`jn_get_job`	Get a single job by jnid
`jn_create_job`	Create a new job (with Lead Number, Job Number, GPS, Plus Code)
`jn_update_job`	Update job fields + GHL migration fields
`jn_list_notes`	List notes on a contact or job
`jn_create_note`	Add a note to a contact or job
`jn_list_files`	List file/photo attachments
`jn_list_tasks`	List tasks
`jn_create_task`	Create a task
`jn_list_estimates`	List estimates
`jn_list_invoices`	List invoices
`jn_list_activities`	List activity records
`jn_list_material_orders`	List material orders
`jn_list_work_orders`	List work orders
`jn_get_account`	Get account info, stages, custom field definitions

Installation

1. Install dependencies and build

cd jobnimbus-mcp
npm install
npm run build

2. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "jobnimbus": {
      "command": "node",
      "args": ["/FULL/PATH/TO/jobnimbus-mcp/dist/index.js"],
      "env": {
        "JOBNIMBUS_API_KEY": "your-jobnimbus-api-key"
      }
    }
  }
}

Replace /FULL/PATH/TO/jobnimbus-mcp with the actual absolute path where you placed this folder.

3. Restart Claude Desktop

The JobNimbus tools will appear in Claude's tool list.

GHL → JobNimbus Migration: Custom Fields

When migrating assets from GoHighLevel, use custom_fields_json to write GHL data into JobNimbus custom fields:

{
  "Lead Number": "L-1234",
  "Job Number": "J-5678",
  "Plus Code": "87JC+9W Edmonton",
  "GPS Coordinates": "53.5461,-113.4938"
}

Example prompt to Claude:

"Update JobNimbus job [jnid] with GHL Lead Number L-1234, Job Number J-5678, and Plus Code 87JC+9W"

Security Note

⚠️ Rotate your API key in JobNimbus Settings → API if it has been shared in any chat or document. Generate a new key and update the config above.