JobNimbus MCP Server

What is JobNimbus MCP Server?

JobNimbus MCP Server is a Model Context Protocol (MCP) server that enables AI assistants like Cursor and Claude to read and write data in JobNimbus (Contacts, Jobs, Tasks, Products, Workflows, Invoices) using a JobNimbus API key. It is designed for users who want to automate or interact with their JobNimbus records through a natural-language interface.

How to use JobNimbus MCP Server?

Install and run via npx jobnimbus-mcp-server. For Cursor or Claude Desktop, add the server configuration to the assistant’s MCP settings file (~/.cursor/mcp.json or claude_desktop_config.json), set the JOBNIMBUS_API_KEY environment variable inside the configuration, and restart the assistant. Advanced users can run the server manually by exporting the API key and executing npx jobnimbus-mcp-server.

Key features of JobNimbus MCP Server

• Runs on npm with zero installation steps (uses npx).
• Works with Cursor Editor and Claude Desktop App.
• Provides 20+ tools covering Contacts, Jobs, Tasks, Products, Workflows, and Invoices.
• All tools support CRUD operations and JobNimbus API integration.
• API key authentication via environment variable JOBNIMBUS_API_KEY.
• Communicates over stdio for MCP compatibility.

Use cases of JobNimbus MCP Server

• List, get, create, or update contacts in JobNimbus.
• Manage jobs: create, update, list, or fetch individual jobs.
• Handle tasks and products within your JobNimbus account.
• Retrieve all workflows and create new workflow statuses.
• Create, update, send invoices, and record payments.

FAQ from JobNimbus MCP Server

How do I set it up in Cursor Editor?

Create a file ~/.cursor/mcp.json with the server configuration, including command: "npx", args: ["jobnimbus-mcp-server"], and the JOBNIMBUS_API_KEY environment variable set to your actual JobNimbus API key. Restart Cursor to activate.

How do I set it up in Claude Desktop App?

Locate the Claude configuration file (claude_desktop_config.json), add the same mcpServers block with command: "npx" and args: ["jobnimbus-mcp-server"], and set JOBNIMBUS_API_KEY in the env section. Restart the app.

What tools are available?

The server implements tools for Contacts, Jobs, Tasks, Products (each with list/get/create/update), Workflows (get all, create workflow, create status), and Invoices (list/get/create/update, send, record payment). Tool names follow the pattern jobnimbus_<entity>_<action>.

Do I need Node.js and npm?

Yes, Node.js and npm are required because the server is run via npx, which needs npm to download the package.

Can I run the server manually without an AI assistant?

Yes. Export the JOBNIMBUS_API_KEY environment variable and run npx jobnimbus-mcp-server. The server will listen for MCP communication over stdin/stdout.