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": "mqalwrda6zbamv2x"
      }
    }
  }
}

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.