io.usefulapiPublished by usefulapi.ioOfficial publisherv1.39.1Updated Nov 14, 2026
Look up Kickserv customers, jobs, notes and time entries, and create jobs, tasks and charges.
The publisher's own server: Ably MCP by usefulapi
Hosted Kickserv MCP server that lets an assistant look up customers, jobs, notes and time entries, and create or update customers, jobs, tasks, notes, time…
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.usefulapi%2Fkickserv/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"kickserv-by-usefulapi": {
"type": "http",
"url": "https://kickserv.usefulapi.io/mcp"
}
}
}Use Kickserv from Claude, Cursor, or any MCP client — look up customers, jobs, notes and time entries, and create or update customers, jobs, tasks, notes, time and charges. Hosted, no local install: connect with your own Kickserv credentials.
Live endpoint: https://kickserv.usefulapi.io/mcp · Homepage: https://usefulapi.io/kickserv
https://kickserv.usefulapi.io/mcp.claude mcp add --transport http kickserv https://kickserv.usefulapi.io/mcp, then run /mcp to log in.Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Kickserv credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/kickserv/
On first connect you'll provide your Kickserv account slug (from app.kickserv.com/) and employee API token (My Account > API token). They're validated, stored per-user, and scoped to you — no keys in config files.
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Each paid plan covers this server only. Ask your AI to run kickserv_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with kickserv_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with kickserv_upgrade before then undoes the cancel. Or write to [email protected].
MIT © usefulapi. Not affiliated with or endorsed by Kickserv.
Source: servers/kickserv/README.md at commit f22f848
List customers
List or search customers, 30 per page. Every filter is an exact match on that field. Use `only` to keep the response small. Kickserv: GET /{account}/customers.xml.
nameonlypageincludebilling_cityphone_numberservice_citybilling_stateemail_addressservice_statecustomer_numberservice_zip_codeGet a customer
Fetch one customer by customer number, optionally with related contacts, jobs, tasks and notes. The result's `id` is what job/task create calls need as `customer_id`. Kickserv: GET /{account}/customers/{customer_number}.xml.
includecustomer_numberrequiredList a customer's jobs
List the jobs for one customer, 30 per page. Kickserv: GET /{account}/customers/{customer_number}/jobs.xml.
onlypageincludecustomer_numberrequiredList jobs
List jobs (work orders, estimates, invoices), 30 per page, filterable by schedule window, status, assigned employee, category (job type) or job status. Kickserv: GET /{account}/jobs.xml.
onlypagestatusincludescheduledjob_type_idjob_status_idemployee_numberGet a job
Fetch one job by job number, optionally with its customer, assigned employees, job charges (line items), time entries and notes. Kickserv: GET /{account}/jobs/{job_number}.xml.
includejob_numberrequiredList a customer's notes
List the notes on one customer. Kickserv: GET /{account}/customers/{customer_number}/notes.xml.
customer_numberrequiredList a job's notes
List the notes on one job. Kickserv: GET /{account}/jobs/{job_number}/notes.xml.
job_numberrequiredList a job's time entries
List the time entries (hours logged by technicians) on one job. Kickserv: GET /{account}/jobs/{job_number}/time_entries.xml.
job_numberrequiredGet a task
Fetch one task (appointment / to-do attached to a job) by id. Kickserv: GET /{account}/tasks/{task_id}.xml.
task_idrequiredList employees
List all employees (technicians and office staff), active and inactive. Use their `id` for job/task assignment and time entries, and `employee_number` to filter jobs. Kickserv: GET /{account}/employees.xml.
Takes no parameters.
List items
List products/services (the price list used for job charges), 30 per page. Active items only by default. Kickserv: GET /{account}/items.xml.
namepagewhichCreate a customer
WRITE: create a new customer. Kickserv assigns the customer number. Kickserv: POST /{account}/customers.xml.
faxnamerequiredmobilecompanycontactis_activelast_namefirst_namealt_contactbilling_citycompany_namephone_number+19 moreUpdate a customer
WRITE: update fields on an existing customer. Only the fields you pass change. Balances, credit limit and custom fields are not settable here. Kickserv: PATCH /{account}/customers/{customer_number}.xml.
faxnamemobilecompanycontactis_activelast_namefirst_namealt_contactbilling_citycompany_namephone_number+20 moreAdd a note to a customer
WRITE: add a note to a customer. Set `public` to true to make it visible to the customer. Kickserv: POST /{account}/customers/{customer_number}/notes.xml.
noterequiredpubliccustomer_numberrequiredCreate a job
WRITE: create a job (work order) for a customer. `customer_id` is the customer's internal `id` (from kickserv_get_customer), not the customer number; `job_type_id` is the job category. Set `estimate` to create it as an estimate. Kickserv: POST /{account}/jobs.xml.
nameends_atdurationestimatepo_numbercustomer_idrequireddescriptionjob_type_idrequiredemployee_idsscheduled_onUpdate a job
WRITE: update an existing job — reschedule it, rename it, change its description, category or custom job status, or reassign employees (employee_ids replaces the assignment). Totals, tax and payment fields are not settable here. Kickserv: PATCH /{account}/jobs/{job_number}.xml.
nameends_atdurationpo_numberjob_numberrequireddescriptionjob_type_idemployee_idsscheduled_onjob_status_idAdd a note to a job
WRITE: add a note to a job. Set `public` to true to make it visible to the customer. Kickserv: POST /{account}/jobs/{job_number}/notes.xml.
noterequiredpublicjob_numberrequiredCreate a task
WRITE: create a task (appointment / to-do) on a job and optionally assign employees. `job_id` is the job's internal `id` (from kickserv_get_job), not the job number. Kickserv: POST /{account}/tasks.xml.
namerequiredjob_idrequiredends_atdurationcustomer_iddescriptionemployee_idsscheduled_attask_type_idrequiredLog time on a job
WRITE: log hours worked by an employee on a job. `employee_id` is the employee's `id` from kickserv_list_employees. Kickserv: POST /{account}/jobs/{job_number}/time_entries.xml.
notemileagebillableended_onjob_numberrequiredstarted_onrequiredemployee_idrequirednumber_of_hoursrequiredtime_entry_type_idAdd a charge to a job
WRITE: add a charge (line item — a product, service or part) to a job. This changes the job's estimate/invoice total; it does NOT charge the customer's card. Pick `item_id` from kickserv_list_items. Kickserv: POST /{account}/jobs/{job_number}/job_charges.xml.
detailsitem_iddiscountquantityjob_numberrequireddescriptionprice_per_unitjob_charge_type_idrequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
io.usefulapiOfficial publisher
Hosted MCP server for Ably that lets an assistant inspect realtime channels, presence and usage stats, publish messages, and review app configuration.
io.usefulapiOfficial publisher
Remote MCP server for Oyster that lets an assistant read team, time off, expense, contract and invoice data and approve or decline requests.
io.usefulapiOfficial publisher
Reads Avirato hotel PMS data — reservations, availability, rates, prices and meal plans — and records cash payments on bookings.
io.usefulapiOfficial publisher
Hosted read-only MCP server that lets an assistant list interview, participant and department metadata from a Willo account.
io.usefulapiOfficial publisher
Hosted MCP server that lets an assistant read Testlify hiring workspace details, assessments and assessment candidates.
{ "mcpServers": { "kickserv": { "url": "https://kickserv.usefulapi.io/mcp" } }}