Overview
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.
