English Français العربية

Jobkeepr

السجل الرسمي الإنتاجية

Manage jobs, customers, scheduling, estimates and invoices for a field service business.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http jobkeepr 'https://jobkeepr.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "jobkeepr": {
            "type": "http",
            "url": "https://jobkeepr.com/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Jobkeepr MCP server
  2. Two ways to connect
  3. Setup
  4. Tools
  5. What it will not do
  6. Configuration
  7. How it works
  8. Development
  9. Links

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 claude_desktop_config.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
ToolWhat it does
get_business_contextBusiness name, timezone, working hours, and today's date with resolved ranges for "this week", "last month" and so on
get_jobsJobs filtered by date, status, customer, type or source
get_customersSearch customers, optionally with job counts and totals
get_scheduleScheduled jobs, calendar events, and open time slots
get_estimatesEstimates and their status
get_invoicesInvoices and unpaid balances
get_paymentsPayments received
get_line_itemsLine items across jobs, for margin and mix analysis
get_reference_dataJob types, lead sources, and the price catalog
Writing
ToolWhat it does
create_jobBook a job for a customer
create_eventAdd a calendar event that is not a job, like time off or a walkthrough
create_customerAdd a customer
create_estimateCreate an estimate
create_catalog_itemAdd a service or product to the price catalog
add_line_itemsAdd billable line items to a job
set_customer_sourceRecord how a customer found the business
reschedule_jobMove a job to a new date or time
cancel_jobCancel a scheduled job
close_jobsMark jobs complete

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 cancel_job and close_jobs 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

VariableRequiredDefaultNotes
JOBKEEPR_API_KEYyes—From Settings → API Keys. Starts with jk_live_.
JOBKEEPR_URLnohttps://jobkeepr.comOverride only for self-hosted or staging.

An API key acts on one account and carries owner-level access. Revoke it any time in Settings → API Keys. To give an assistant narrower, per-user access instead, use the remote endpoint with OAuth.

How it works

This package is a proxy, not a reimplementation. The tools live on the hosted server; this bridges stdio to it. That means the tool set here is always current and this package rarely needs a release.

Development

npm install
npm run build
JOBKEEPR_API_KEY=jk_live_... node dist/index.js

Test interactively with the MCP Inspector:

JOBKEEPR_API_KEY=jk_live_... npx @modelcontextprotocol/inspector node dist/index.js

MIT licensed.

الأسئلة الشائعة

ما هو Jobkeepr؟

Manage jobs, customers, scheduling, estimates and invoices for a field service business.

كيف أثبّت Jobkeepr؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http jobkeepr 'https://jobkeepr.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Jobkeepr إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Jobkeepr مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Jobkeepr؟

ينشره dandyer. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.