Jobkeepr MCP server

Jobkeepr MCP server

Connect Jobkeepr to Claude, ChatGPT, or any other MCP client, so an AI assistant can read and manage your field service business: jobs, customers, scheduling, estimates, invoices and payments.

Jobkeepr is field service management software for small contractor crews — handymen, TV installers, plumbers, electricians, HVAC techs — running one to ten people.

"What's on my schedule tomorrow?"
"Which service made me the most money last month?"
"Book Sarah Chen for a TV mount Thursday at 2pm."
"Mark today's jobs complete."

Two ways to connect

Remote (recommended). If your client supports remote MCP servers, point it straight at the hosted endpoint and skip this package entirely:

https://jobkeepr.com/mcp

It supports OAuth, so you sign in with your normal Jobkeepr login and approve access in the browser. Nothing to install.

stdio (this package). For clients that only speak stdio, this bridges to the same server using an API key.

This package is not on npm. Install it straight from GitHub using the

github:dandyer/jobkeepr-mcp specifier shown below. Plain npx jobkeepr-mcp will not

resolve. npm compiles the TypeScript for you on install, so there is nothing extra to run.

Setup

Create an API key in Jobkeepr under Settings → API Keys. It's shown once, so copy it then.

Claude Desktop

Add to claudedesktopconfig.json:

{
  "mcpServers": {
    "jobkeepr": {
      "command": "npx",
      "args": ["-y", "github:dandyer/jobkeepr-mcp"],
      "env": {
        "JOBKEEPR_API_KEY": "jk_live_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add jobkeepr --env JOBKEEPR_API_KEY=jk_live_your_key_here -- npx -y github:dandyer/jobkeepr-mcp

Or connect to the remote endpoint directly:

claude mcp add --transport http jobkeepr https://jobkeepr.com/mcp

Tools

Reading

Writing

The financial tools require the VIEW_FINANCIALS permission, and each write tool requires its matching permission. Tools you cannot use are not listed to you.

What it will not do

No tool here can text your customers. Sending SMS is deliberately excluded: it is the one action that reaches a real person and cannot be undone. Ask your assistant to draft a message and send it yourself from Jobkeepr.

Writes take effect immediately. There is no staging step and no undo, which is why canceljob and closejobs are marked destructive so your client prompts before running them. close_jobs can act on many jobs at once, so check the set before approving it.

Configuration

Shortened. The full README is on GitHub.