kickserv-mcp

An MCP server for Kickserv field service management — lets AI agents (Claude, ChatGPT, and any MCP-compatible client) read and manage customers, jobs, and invoices.

Ask your AI assistant things like:

"Which invoices are overdue and who do I need to call?" "Create a job for Kelly Nakamura — toilet rebuild, estimate $265." "What's my active job pipeline worth right now?"

Zero dependencies. Plain Node 18+. Nothing to install.

Quick start (demo / mock mode)

node src/index.js

With no credentials set, the server runs in mock mode — a realistic sample plumbing-company dataset — so you can demo the full agent experience without touching a live account.

Connect to Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "kickserv": {
      "command": "node",
      "args": ["/absolute/path/to/kickserv-mcp/src/index.js"]
    }
  }
}

Restart Claude Desktop and ask: "What's in my Kickserv account?"

Related MCP server: qb-mcp

Live mode

export KICKSERV_ACCOUNT=your-account-slug
export KICKSERV_API_TOKEN=your-api-token
node src/index.js

Live mode targets Kickserv's REST API using HTTP Basic auth with your API token. Verify endpoint paths against your account's developer docs before production use.

Tools

Tests

npm test

Spawns the server over stdio and exercises the full protocol: initialize → tools/list → tool calls. 8 checks.

Why this exists

AI agents are becoming the interface to business software. Field service platforms that agents can't talk to will lose deals to ones they can. This server is a working demonstration of what "agent-ready" looks like for a field service product — built as a portfolio piece by Will Brownfield, who builds MCP integrations for SaaS companies.

Want your product to be agent-ready? Email me: willbrownfield@icloud.com

License

MIT