# JobNimbus — MCP server on mcp.ai
> Connect your JobNimbus account and use 21 tools for CRM straight from your AI agent. Connect with your own API key. JobNimbus is a CRM and project management software designed for contractors, helping streamline scheduling, estimates, invoicing, and job tracking.

By: mcp.ai · official
Page: https://mcp.ai/jobnimbus

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_jobnimbus?ms=1787291400000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/jobnimbus/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/jobnimbus/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/jobnimbus/skill.md
Postman collection (v2.1): https://mcp.ai/jobnimbus/postman.json

## Tools
- jobnimbus_account_create_location(zip?: string, city?: string, code?: string, name: string, phone?: string, is_active?: boolean, state_text?: string, country_name?: string, address_line1?: string, address_line2?: string) — Tool to create a new location in JobNimbus. Use after gathering address and contact details.
- jobnimbus_account_get_settings(actor?: string) — Tool to retrieve account-wide settings (workflows, types, sources). Use after authenticating to load or refresh workflow and source mappings.
- jobnimbus_activity_get(jnid: string) — Retrieves a specific JobNimbus activity by its unique jnid. Activities in JobNimbus represent logged events such as task modifications, contact updates, job creation, and other system actions. Each ac
- jobnimbus_contact_get(jnid: string) — Tool to retrieve a contact by ID. Use after obtaining the contact’s jnid to fetch full details.
- jobnimbus_contact_list(from?: integer, size?: integer, fields?: string, filter?: string, sort_field?: string, sort_direction?: string) — Tool to list all contacts. Use when you need to fetch multiple contacts, e.g., for reporting or synchronization.
- jobnimbus_contact_update(zip?: string, city?: string, jnid: string, tags?: string[], email?: string, company?: string, website?: string, lastName?: string, faxNumber?: string, firstName?: string, homePhone?: string, stateText?: string, workPhone?: string, externalId?: string, sourceName?: string, statusName?: string, contactType?: string, description?: string, displayName?: string, mobilePhone?: string, addressLine1?: string, addressLine2?: string, salesRepName?: string) — Tool to update an existing contact. Use when you have a contact's JNID and need to modify its fields. Call after fetching or creating a contact.
- jobnimbus_create_file_type(IsActive?: boolean, TypeName: string) — Creates a new file attachment type in JobNimbus. File types are custom categories used to organize and classify document attachments (e.g., contracts, warranties, photos, permits). You must create a f
- jobnimbus_create_material_order(items: object[], notes?: string, number?: string, status?: integer, related: object[], vendorId?: integer, assignedToId?: integer, expectedDate?: string) — Creates a new material order in JobNimbus. A material order tracks materials needed for a job and can be submitted to suppliers. Material orders must be linked to a contact or job record and include a
- jobnimbus_create_task(title: string, related?: object[], date_end?: integer, date_start: integer, record_type?: integer, record_type_name: string) — Tool to create a new task. Use when scheduling or tracking tasks linked to contacts or jobs.
- jobnimbus_create_workflow_status(name: string, is_lead?: boolean, is_active?: boolean, is_closed?: boolean, workflowid: string, is_archived?: boolean, force_mobile_sync?: boolean, send_to_quickbooks?: boolean) — Tool to create a new status in an existing workflow. Use after confirming the workflow ID to add specialized status entries like 'Lead' or 'Inspection'.
- jobnimbus_file_get(jnid: string) — Retrieves the raw content of a specific file attachment from JobNimbus by its unique ID. This action downloads the actual file content (binary data for PDFs, images, etc.) but does NOT return file met
- jobnimbus_list_activities(size?: integer, filter?: string, offset?: integer, sort_field?: string, sort_direction?: string) — Tool to retrieve all activities. Use after authentication to fetch a paginated list of activities.
- jobnimbus_list_invoices(from?: integer, size?: integer, fields?: string, filter?: string, sort_field?: string, sort_direction?: string) — Tool to list all invoices (v2). Use when you need to fetch multiple invoice records.
- jobnimbus_list_material_orders(from?: integer, size?: integer, fields?: string, filter?: string, sort_field?: string, sort_direction?: string) — Tool to list all material orders (v2). Use after authentication to fetch multiple material order records.
- jobnimbus_list_payments(page?: integer, jobId?: integer, dateTo?: string, perPage?: integer, dateFrom?: string, contactId?: integer) — Tool to retrieve payments list with optional filters. Use after auth.
- jobnimbus_list_products(from?: integer, size?: integer, fields?: string, filter?: string, sort_field?: string, sort_direction?: string) — Tool to list all products. Use after authentication to fetch full product catalog.
- jobnimbus_list_workorders(from?: integer, size?: integer, fields?: string, filter?: string, sort_field?: string, sort_direction?: string) — Tool to retrieve all work orders (v2). Use after authentication when you need a paginated list of work orders.
- jobnimbus_product_get(jnid: string) — Retrieves detailed information about a specific JobNimbus product using its jnid. Use this action when you need to get full details about a product, including pricing, cost, unit of measurement, and t
- jobnimbus_task_list(page?: integer, status?: string, due_date?: string, per_page?: integer, assigned_to?: integer) — Tool to list all tasks. Use when you need an overview of tasks for planning or review.
- jobnimbus_update_task(jnid: string, title?: string, date_end?: integer, priority?: integer, date_start?: integer, description?: string, record_type?: integer, record_type_name?: string) — Update an existing JobNimbus task by its jnid. Allows updating task details like title, description, dates, priority, and task type. Use List Tasks action to find task jnids. Note: To update task type
- jobnimbus_utility_get_uoms() — Tool to retrieve list of supported units of measure. Use after authenticating when you need to present or validate measurement units.

## Example prompts
- "What can I do in JobNimbus?"
- "Show me a summary of my JobNimbus account"

## Links
Docs: https://mcp.ai/docs/mcps/jobnimbus
Website: https://mcp.ai/mcps/jobnimbus