Kickserv MCP Server

Kickserv'de işler, müşteriler, tahminler ve faturalar.

Barındırılan MCP Sunucusu

npx add-mcp 'https://cotlet.dev/mcp/v1/kickserv'

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Kickserv API and MCP server: Let your AI agent do the Kickserv paperwork.

Kickserv has no MCP server. Its API is XML over HTTP, "available to premium plans only", and has no endpoint for estimates, invoices or payments (API docs, checked 27 Oct 2026). Cotlet runs 15 Kickserv tools hosted, over MCP for agents and REST for scripts, in your own Kickserv login on any plan.

Jobs, customers, estimates and invoices in Kickserv. Use it in ChatGPT, Claude or any AI agent over MCP, or in n8n, Make and scripts over REST.

MCP setup REST API guide

What can you automate in Kickserv?

  • Turn lead emails into opportunities
  • Build an estimate from your site notes
  • Invoice the jobs finished yesterday
  • Log checks and cash on the right invoice
  • Put unscheduled jobs on a tech's day
  • Log the crew's hours on each job

Does Kickserv have an MCP server or an API?

  • The API reads and writes customers, jobs, charges, tasks and time entries, 30 records a page, with an employee's token that changes when that employee changes their password.
  • Premium is the only plan with API tokens, and the pricing page lists Start ($60), Run ($119) and Scale ($199) with no Premium price.
  • Kickserv has no Zapier app, no webhooks and no n8n node.
What you needKickserv APIMCP servers on the APICotlet
Customers, jobs, charges, hoursYes, in XMLYesYes
Put a job on a tech's calendarYes, as a taskSome serversYes, after your OK
Send an estimateNoNoYes, after your OK
Generate and send an invoiceNoNoYes, sending after your OK
Log a check or cash paymentNoNoYes, after your OK
Kickserv plan neededPremium, price on requestPremiumAny

Checked 27 Oct 2026. Sources: Kickserv API documentation, Kickserv help: Developer API, Kickserv pricing, Kickserv integrations, Supergood API report card: Kickserv

How does Cotlet connect to Kickserv?

  1. Sign in to Kickserv. Use your own account in its Cotlet Cloud Browser.
  2. Choose MCP or REST. Connect your agent or create a Cotlet API key.
  3. Run your workflow. Ask your agent or send an HTTP request.

We never keep your Kickserv password, and no estimate, invoice, payment or calendar event goes through until you approve it.

Connect Kickserv to your agent or workflow

Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.

  1. Sign in to Kickserv in a Cloud Browser. Create a Cotlet account, open Kickserv in its Cloud Browser, sign in with the owner or office login (password or magic link) and press Enable for agents.
  2. Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
  3. Let the agent in. Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

Kickserv shares the address https://cotlet.dev/mcp/v1 with every other app you enable, so one connector covers them all. Turned Kickserv on after connecting? Refresh the connector and the 15 tools appear.

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: kickserv_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: kickserv_write

How to use the Kickserv REST API

Create your Cotlet API key

Create a Cotlet API key with access to Kickserv and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Connect Kickserv in Cotlet and enable it for agents. Account access: Your own Kickserv account (admin role for invoices and payments).

Make your first Kickserv API request

REST:

curl https://cotlet.dev/api/v1/kickserv/customers \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read customers and apply the operation limits

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "kickserv",
  "tool": "list_customers",
  "result": {
    "customers": [
      {
        "customer_number": "2218",
        "name": "Lee Residence",
        "email": "lee@example.com",
        "phone": "555-0142",
        "service_address": "41 Maple St, Austin, TX 78701"
      }
    ],
    "page": 1
  }
}

Returns customers with their number, contact details and service address. Search matches name, email, phone and street address.

Pass the customer_number to get_customer, create_job and the other tools.

page: Page number. Default: 1.

This list accepts a page number, but its response exposes no total, continuation cursor or end flag. Do not assume a termination field that is not returned.

Keep the same selection when continuing a list. Compare changed record values as well as identifiers when refreshing your destination.

Kickserv workflows for agents and automations

ToolConnect throughExample workflow
n8nHTTP RequestJobs with status, service type, customer, assigned techs and scheduled date. Use list_jobs in your configured business report.
MakeHTTP > Make a requestFull job: description, scope of work, charges, schedule events, time entries, notes and invoice status. Use get_job in your configured business report.
Python or Node.jsREST APIInvoices with customer, total, balance and whether they were sent and viewed. Use list_invoices in your configured business report.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

Cotlet reads Kickserv; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.

Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.

Kickserv API endpoints and MCP tools

Customers

Search matches name, email, phone and street address, so a repeat caller is found before a duplicate is made. Adding a customer needs the Contacts permission on your login.

  • List customers (list_customers, read): Customers and contacts, searchable by name, email, phone or address.
  • Get customer (get_customer, read): One customer with addresses, contacts, notes and jobs.
  • Create customer (create_customer, write): New person or company contact with service and billing address.

Opportunities and estimates

An opportunity is a job with as_opportunity set; it sits under New until the estimate goes out. Charges are added one line at a time and reach the customer only through send_estimate.

  • List opportunities (list_opportunities, read): Opportunities with customer, service type and whether an estimate was sent.
  • Create job (create_job, write): New job, or a new opportunity to estimate first, for a customer.
  • Add charge (add_charge, write): Add one charge item to the estimate or invoice of a job or opportunity.
  • Send estimate (send_estimate, write, asks first): Email the estimate of an opportunity to the customer.

Jobs, schedule and hours

Lists come 30 jobs a page, filtered by status, date or technician. An event with no technician stays unassigned, and your reminder settings decide whether Kickserv reminds anyone about it.

  • List jobs (list_jobs, read): Jobs with status, service type, customer, assigned techs and scheduled date.
  • Get job (get_job, read): Full job: description, scope of work, charges, schedule events, time entries, notes and invoice status.
  • Schedule event (schedule_event, write, asks first): Add a work event to a job, optionally assigned to a technician.
  • Log time entry (log_time_entry, write): Record hours worked on a job by an employee.

Invoices and payments

An invoice is built from the job's charges and can be edited until it is sent. Payments are checks, cash and other manual types; no card is charged. These tools need an admin login or the Payments permission.

  • List invoices (list_invoices, read): Invoices with customer, total, balance and whether they were sent and viewed.
  • Generate invoice (generate_invoice, write): Create the invoice for a job from its charges. Nothing is sent.
  • Send invoice (send_invoice, write, asks first): Email the invoice of a job to the customer.
  • Record payment (record_payment, write, asks first): Log a manual payment (check, cash, other) on a job and mark the invoice paid. No card is charged.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/kickserv-api-mcp-server#tools

Who can see my Kickserv session, and how do I revoke it?

  • What we store. Your signed-in Kickserv profile, AES-256-GCM encrypted, in Finland. No password.
  • What your agent gets. The 15 Kickserv tools, never the session cookie.
  • What the session sees. What your login sees: customers, job prices, invoices, payments.
  • What no tool touches. Card charges, Stripe, QuickBooks sync, employees, plan, deletes.
  • If Kickserv signs you out. You sign in again yourself, with a password or a magic link.
  • How to cut access. Disable for agents, reset the browser, or change your Kickserv password.

Kickserv locks a login after 5 failed sign-ins. Cotlet never types your password, so its tools cannot set that lock off. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results). There is no SOC 2 report or third-party pentest yet.

Is it against Kickserv's terms? Account safety

In accessing or using the Service, Customer will not: ... (c) apply systems to extract or modify information in the Service using technology or method such as those commonly referred to as "web scraping," "data scraping," or "screen scraping"

Kickserv Terms of Service, 1.3, last modified 21 Aug 2024

Cotlet works in Kickserv's web app the way a browser does, so Kickserv can read 1.3(c) as covering it. Section 1.6 lets Kickserv "immediately suspend the Service" to stop "unauthorized or non-compliant use", and section 1.2 wants a user license for each person on the account. Kickserv also offers the API for the same data on Premium. We found no public case of a Kickserv account suspended for automation (checked 27 Oct 2026). You decide whether the risk fits your business.

How we keep your Kickserv looking like your office:

  • Your own Kickserv login, signed in by you
  • One Cloud Browser with a steady IP and cookies
  • Estimates, invoices, payments and calendar events wait for your OK (4 tools)
  • No tool deletes a customer, job, charge or payment
  • If Kickserv objects, we pause the Kickserv tools for everyone within 24 h

Kickserv plans count users (Start has 5). If the agent should not act as you, give it a user seat of its own so the history shows which changes it made.

What happens when Kickserv changes?

  • 12 h between tests of the Kickserv job and invoice reads
  • 24 h between tests of sends a customer would notice
  • $0 for a call to a Kickserv tool paused for repair

Kickserv has redesigned its own Jobs page before and moved every account from name.kickservapp.com to app.kickserv.com/name. When a change like that moves the Send button in the invoice header or a tab on the Opportunities page, we fix the tool and your agent calls it the same way. status.cotlet.dev checks the site, console and API every 3 minutes.

Approvals, undo and mistakes

  1. Reads yesterday's completed jobs. Every page of 30, until a short one comes back.
  2. Holds back what is not ready. No charges, a zero total or a second visit still booked.
  3. Generates and checks totals. Each invoice against the charges it read on the job.
  4. Waits, then sends. The batch shows up in your Cotlet console first.
ActionUndo
Add a chargeYes, remove the line in Kickserv before sending
Generate an invoiceYes, edit it; Kickserv voids by setting charges to $0
Schedule an eventMove or delete it; a reminder already sent stays sent
Record a paymentMark unpaid, then delete the payment on the job
Send an estimate or invoiceNo

4 of 15 tools ask first: schedule_event, send_estimate, send_invoice and record_payment. A new customer, an opportunity, a charge line, a generated invoice or a time entry reaches no customer, so they run at once. You can turn the wait off per tool, for example for the daily invoice run once you trust it.

Kickserv starts invoice reminders only after an invoice was sent by hand or by send_invoice once. An invoice that was generated and never sent gets no reminder, which is why the run sends what is ready.

MCP call:

{
  "name": "send_invoice",
  "arguments": {
    "job_number": "1037"
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/kickserv/jobs/1037/invoices \
  -H "Authorization: Bearer $COTLET_API_KEY"

Response:

{
  "job_number": "1037",
  "invoice_status": "sent",
  "sent_to": [
    "lee@example.com"
  ],
  "total": "480.00",
  "balance_remaining": "480.00"
}

A cron job or n8n flow can call the same tools over REST at /api/v1/kickserv with the same key and price, in JSON, not Kickserv's XML. A send for a job number that does not exist fails, and failed calls are free. Each tool row above shows its REST path.

How much does the Kickserv MCP server cost?

About $56 a month for a plumbing shop with 4 technicians, 9,640 credits. Your Kickserv plan stays as it is; Premium is not needed.

JobCallsCredits
Web lead into an opportunity4 × 301,200
Estimate of 5 lines, built and sent7 × 201,400
Yesterday's 6 jobs invoiced, each workday19 × 224,180
Checks and cash logged, weekly (6)13 × 4520
Unscheduled job put on a calendar2 × 20400
Technician hours logged, weekly11 × 4440
Cloud Browser, 30 days1,500
Total9,640
  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • Works on Start, Run and Scale

Reviews put the typical Kickserv customer at 2 to 10 technicians (ServiceMag, Apr 2026), and Kickserv publishes no job counts, so the month is our example. For scale, Kickserv Start for 5 users is $60 a month billed yearly. Dollars at the $29 pack rate.

Kickserv MCP server on GitHub, Zapier or hosted: which to use

OptionWhat it doesWhere it stops
Willbrownfield007/kickserv-mcp7 tools on GitHub: customers, jobs, create job, invoices from job fields, a revenue snapshot. 0 stars.Runs on your computer with a Premium token; last push 9 Jul 2026, no license file.
usefulapi Kickserv connector20 hosted tools: customers, jobs, notes, time entries, tasks and charges. Free tier.Premium token; no estimates, invoices or payments; 64.7% uptime over 27 days on Glama.
Weavz37 tools and 1 polling trigger on the official API.Answers come back as Kickserv's raw XML; nothing that sends or pays.
CarlyTakes an employee token and brings jobs, customers, tasks and time into Claude, also on a schedule.Premium token; AI agents from $35 a month.
SupergoodBuilds a managed API or MCP server for your company.Sales call; no public price.

Zapier has no Kickserv app. If you are on Premium and only need reads, a token-based server is cheaper. For sending estimates and invoices and logging checks, which no API route does, Cotlet works in the Kickserv account you already pay for.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Take Group sp. z o.o. runs Cotlet. It is a software company registered in Poland, EU (VAT PL6342984273), in business since 2019, led by its founders Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Kickserv tools go to contact@cotlet.dev.

Kickserv API and MCP: questions

How do I get access?

Sign up free at https://cotlet.dev, open Kickserv under Integrations in the console and sign in to Kickserv in its Cloud Browser. The trial starts when you sign up and asks for no card.

How do I connect Kickserv to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Kickserv once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Kickserv account through Cotlet, in their phone apps too.

What can ChatGPT do in Kickserv?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Kickserv: add leads as opportunities; build and send an estimate; invoice completed jobs. You ask in plain words, and anything that reaches other people waits for your OK first.

Is there an official ChatGPT or Claude app for Kickserv?

No. Kickserv has no ChatGPT or Claude connector of its own (checked 8 Nov 2026). Cotlet is an independent one that works in ChatGPT, Claude, Cursor and any MCP client, on your signed-in account.

Can ChatGPT create and schedule a job in Kickserv?

Yes, with Cotlet. ChatGPT adds the customer, creates the job, adds the charges and books the schedule event in your Kickserv account. You ask in plain words.

Can ChatGPT send an invoice in Kickserv?

Yes, with Cotlet. ChatGPT generates the invoice from the job, sends it to the customer and records the payment when it comes in. Sending waits for your OK by default.

Do I need a premium plan to use Kickserv with Cotlet?

No. Cotlet works through your own Kickserv sign-in, so it needs no API token, which Kickserv gives only to premium plans. It can do what your plan and role can do in the app. Check the plan details on Kickserv's pricing page.

Can it charge a customer's card?

No. record_payment only logs a manual payment such as a check or cash, and marks the invoice paid. Online payments stay in Kickserv.

Can it react when a lead comes in?

Kickserv has no webhooks and no Zapier app, so nothing in Kickserv can start your agent. Run it on a schedule, for example every morning at 7 for last night's lead emails.

Does it sync with QuickBooks?

Kickserv keeps its own QuickBooks sync. Invoices and payments the agent records are Kickserv records, so they sync the same way as ones you enter by hand. No tool changes the sync settings.

Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 15 tools, inputs, answers, API key and price. Agents use MCP; scripts and HTTP steps use REST.

Is Cotlet affiliated with Kickserv?

No. Cotlet is independent and not affiliated with Kickserv or Norman's Dojo, Inc.

Can I use the Kickserv API without an AI agent?

Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.


Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.