Paymo MCP by usefulapi is an MCP server published by io.usefulapi, hosted at paymo.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 21 tools, including paymo_get_me, paymo_get_company, paymo_list_users, paymo_list_clients, paymo_list_projects.
Browse Paymo projects, tasks, timesheets and invoices, and create tasks, log time or run timers.
4,211 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Fetch the Paymo user the API key belongs to (id, name, type, timezone). Use the id as user_id for 'my' time entries and timers. A cheap way to confirm the key works. Paymo: GET /api/me.
No parameters.
{
"name": "paymo_get_me",
"title": "Get the current user",
"description": "Fetch the Paymo user the API key belongs to (id, name, type, timezone). Use the id as user_id for 'my' time entries and timers. A cheap way to confirm the key works. Paymo: GET /api/me.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the current user",
"readOnlyHint": true
}
}Fetch the company (account) info and settings: name, default currency, timezone, working days, invoice numbering. Paymo: GET /api/company.
No parameters.
{
"name": "paymo_get_company",
"title": "Get company info",
"description": "Fetch the company (account) info and settings: name, default currency, timezone, working days, invoice numbering. Paymo: GET /api/company.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get company info",
"readOnlyHint": true
}
}List users in the company (id, name, email, type, hourly rate, assigned/managed projects). Paymo: GET /api/users.
| Parameter | Type | Description |
|---|---|---|
| type | string | Only users of this type. |
| limit | integer | Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated. |
| where | string | Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b). |
| active | boolean | true = active users only, false = retired users only. |
{
"name": "paymo_list_users",
"title": "List users",
"description": "List users in the company (id, name, email, type, hourly rate, assigned/managed projects). Paymo: GET /api/users.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"Admin",
"Employee",
"Guest"
],
"type": "string",
"description": "Only users of this type."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated."
},
"where": {
"type": "string",
"maxLength": 500,
"description": "Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b)."
},
"active": {
"type": "boolean",
"description": "true = active users only, false = retired users only."
}
}
},
"annotations": {
"title": "List users",
"readOnlyHint": true
}
}List clients (id, name, contact details, active flag). Paymo: GET /api/clients.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated. |
| where | string | Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b). |
| active | boolean | true = active clients only, false = archived only. |
| include | string | Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks. |
{
"name": "paymo_list_clients",
"title": "List clients",
"description": "List clients (id, name, contact details, active flag). Paymo: GET /api/clients.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated."
},
"where": {
"type": "string",
"maxLength": 500,
"description": "Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b)."
},
"active": {
"type": "boolean",
"description": "true = active clients only, false = archived only."
},
"include": {
"type": "string",
"pattern": "^[a-z_]+(\\.[a-z_]+)*(,[a-z_]+(\\.[a-z_]+)*)*$",
"maxLength": 300,
"description": "Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks."
}
}
},
"annotations": {
"title": "List clients",
"readOnlyHint": true
}
}List projects (id, name, code, client_id, active, billable, budget_hours, users, managers), optionally filtered. Paymo: GET /api/projects.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated. |
| where | string | Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b). |
| active | boolean | true = active projects, false = archived. |
| include | string | Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks. |
| user_id | integer | Only projects this user is assigned to. |
| billable | boolean | Only billable (true) or non-billable (false) projects. |
| client_id | integer | Only projects for this client. |
| manager_id | integer | Only projects this user manages. |
{
"name": "paymo_list_projects",
"title": "List projects",
"description": "List projects (id, name, code, client_id, active, billable, budget_hours, users, managers), optionally filtered. Paymo: GET /api/projects.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated."
},
"where": {
"type": "string",
"maxLength": 500,
"description": "Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b)."
},
"active": {
"type": "boolean",
"description": "true = active projects, false = archived."
},
"include": {
"type": "string",
"pattern": "^[a-z_]+(\\.[a-z_]+)*(,[a-z_]+(\\.[a-z_]+)*)*$",
"maxLength": 300,
"description": "Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks."
},
"user_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only projects this user is assigned to.",
"exclusiveMinimum": 0
},
"billable": {
"type": "boolean",
"description": "Only billable (true) or non-billable (false) projects."
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only projects for this client.",
"exclusiveMinimum": 0
},
"manager_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only projects this user manages.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List projects",
"readOnlyHint": true
}
}Fetch one project, optionally with related objects inline, e.g. include=tasklists.tasks for the whole task tree or include=client. Paymo: GET /api/projects/{id}.
| Parameter | Type | Description |
|---|---|---|
| include | string | Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks. |
| project_id * | integer | The project id. |
{
"name": "paymo_get_project",
"title": "Get a project",
"description": "Fetch one project, optionally with related objects inline, e.g. include=tasklists.tasks for the whole task tree or include=client. Paymo: GET /api/projects/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id"
],
"properties": {
"include": {
"type": "string",
"pattern": "^[a-z_]+(\\.[a-z_]+)*(,[a-z_]+(\\.[a-z_]+)*)*$",
"maxLength": 300,
"description": "Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The project id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a project",
"readOnlyHint": true
}
}List task lists (id, name, project_id, milestone_id), e.g. to pick a tasklist_id when creating a task. Paymo: GET /api/tasklists.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated. |
| include | string | Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks. |
| project_id | integer | Only task lists from this project. |
{
"name": "paymo_list_tasklists",
"title": "List task lists",
"description": "List task lists (id, name, project_id, milestone_id), e.g. to pick a tasklist_id when creating a task. Paymo: GET /api/tasklists.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated."
},
"include": {
"type": "string",
"pattern": "^[a-z_]+(\\.[a-z_]+)*(,[a-z_]+(\\.[a-z_]+)*)*$",
"maxLength": 300,
"description": "Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only task lists from this project.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List task lists",
"readOnlyHint": true
}
}List tasks (id, name, code, project_id, tasklist_id, complete, due_date, users, priority), filtered by project, task list, assignee or completion. my_tasks=true returns the caller's 'My Tasks'. Paymo: GET /api/tasks.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated. |
| where | string | Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b). |
| include | string | Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks. |
| user_id | integer | Only tasks assigned to this user. |
| complete | boolean | true = completed tasks, false = open tasks. |
| my_tasks | boolean | true = tasks assigned to the calling user or to nobody, in their projects. |
| project_id | integer | Only tasks from this project. |
| tasklist_id | integer | Only tasks from this task list. |
Fetch one task, optionally with related objects: include=thread.comments for its comments, subtasks, entries (time logged), files, project. Paymo: GET /api/tasks/{id}.
| Parameter | Type | Description |
|---|---|---|
| include | string | Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks. |
| task_id * | integer | The task id. |
{
"name": "paymo_get_task",
"title": "Get a task",
"description": "Fetch one task, optionally with related objects: include=thread.comments for its comments, subtasks, entries (time logged), files, project. Paymo: GET /api/tasks/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id"
],
"properties": {
"include": {
"type": "string",
"pattern": "^[a-z_]+(\\.[a-z_]+)*(,[a-z_]+(\\.[a-z_]+)*)*$",
"maxLength": 300,
"description": "Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks."
},
"task_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The task id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a task",
"readOnlyHint": true
}
}List time entries (id, task_id, user_id, project_id, start_time/end_time or date, duration in seconds, description, billed). At least one filter is required. from/to filter by the entry's time interval; running_only=true returns running timers. Paymo: GET /api/entries.
| Parameter | Type | Description |
|---|---|---|
| to | string | Interval end (YYYY-MM-DD = end of that day UTC). Requires `from`. |
| from | string | Interval start (YYYY-MM-DD = start of that day UTC). Requires `to`. |
| limit | integer | Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated. |
| where | string | Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b). |
| billed | boolean | true = already invoiced, false = unbilled. |
| include | string | Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks. |
| task_id | integer | Only entries for this task. |
| user_id | integer | Only entries for this user. |
| client_id | integer | Only entries for this client. |
List invoices (id, number, client_id, status, currency, date, due_date, subtotal, total). Paymo: GET /api/invoices.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated. |
| where | string | Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b). |
| status | string | Only invoices with this status. |
| client_id | integer | Only invoices for this client. |
{
"name": "paymo_list_invoices",
"title": "List invoices",
"description": "List invoices (id, number, client_id, status, currency, date, due_date, subtotal, total). Paymo: GET /api/invoices.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated."
},
"where": {
"type": "string",
"maxLength": 500,
"description": "Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b)."
},
"status": {
"enum": [
"draft",
"sent",
"viewed",
"paid",
"void"
],
"type": "string",
"description": "Only invoices with this status."
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only invoices for this client.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true
}
}Fetch one invoice with totals, and (by default) its line items and payments. Paymo: GET /api/invoices/{id}?include=invoiceitems,invoicepayments.
| Parameter | Type | Description |
|---|---|---|
| invoice_id * | integer | The invoice id. |
| include_items | boolean | Include line items and payments (default true). |
{
"name": "paymo_get_invoice",
"title": "Get an invoice",
"description": "Fetch one invoice with totals, and (by default) its line items and payments. Paymo: GET /api/invoices/{id}?include=invoiceitems,invoicepayments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice_id"
],
"properties": {
"invoice_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The invoice id.",
"exclusiveMinimum": 0
},
"include_items": {
"type": "boolean",
"description": "Include line items and payments (default true)."
}
}
},
"annotations": {
"title": "Get an invoice",
"readOnlyHint": true
}
}List expenses (id, client_id, project_id, user_id, amount, currency, date, notes, invoiced, tags). Paymo: GET /api/expenses.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated. |
| where | string | Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b). |
| date_to | string | Only expenses dated on/before this day. |
| invoiced | boolean | true = already invoiced, false = not yet invoiced. |
| client_id | integer | Only expenses for this client. |
| date_from | string | Only expenses dated on/after this day. |
| project_id | integer | Only expenses for this project. |
{
"name": "paymo_list_expenses",
"title": "List expenses",
"description": "List expenses (id, client_id, project_id, user_id, amount, currency, date, notes, invoiced, tags). Paymo: GET /api/expenses.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated."
},
"where": {
"type": "string",
"maxLength": 500,
"description": "Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b)."
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Only expenses dated on/before this day."
},
"invoiced": {
"type": "boolean",
"description": "true = already invoiced, false = not yet invoiced."
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only expenses for this client.",
"exclusiveMinimum": 0
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Only expenses dated on/after this day."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only expenses for this project.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List expenses",
"readOnlyHint": true
}
}Create a project. Note: if client_id is omitted Paymo auto-creates a 'Sample Client'. Free plans have an active-projects limit (403). Paymo: POST /api/projects.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Project name. |
| users | array | User ids to assign. |
| billable | boolean | Whether the project is billable. |
| managers | array | User ids of managers (subset of users). |
| client_id | integer | Client the project is for. |
| description | string | Project description. |
| budget_hours | number | Budget in hours. |
| price_per_hour | number | Hourly rate for time & materials projects. |
{
"name": "paymo_create_project",
"title": "Create a project",
"description": "Create a project. Note: if client_id is omitted Paymo auto-creates a 'Sample Client'. Free plans have an active-projects limit (403). Paymo: POST /api/projects.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Project name."
},
"users": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"description": "User ids to assign."
},
"billable": {
"type": "boolean",
"description": "Whether the project is billable."
},
"managers": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"description": "User ids of managers (subset of users)."
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Client the project is for.",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"description": "Project description."
},
"budget_hours": {
"type": "number",
"minimum": 0,
"description": "Budget in hours."
},
"price_per_hour": {
"type": "number",
"minimum": 0,
"description": "Hourly rate for time & materials projects."
}
}
},
"annotations": {
"title": "Create a project",
"destructiveHint": true
}
}Create a task in a task list (tasklist_id) or a project (project_id — goes to its 'Default Task List'). Paymo: POST /api/tasks.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Task name. |
| users | array | Assignee user ids. |
| billable | boolean | Whether the task is billable. |
| due_date | string | Due date. |
| priority | any | Priority: 25 low, 50 normal, 75 high, 100 critical. |
| project_id | integer | Project to add the task to (used when tasklist_id is not given). |
| description | string | Task description / notes. |
| tasklist_id | integer | Task list to add the task to. |
| budget_hours | number | Budget hours for the task. |
{
"name": "paymo_create_task",
"title": "Create a task",
"description": "Create a task in a task list (tasklist_id) or a project (project_id — goes to its 'Default Task List'). Paymo: POST /api/tasks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Task name."
},
"users": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"description": "Assignee user ids."
},
"billable": {
"type": "boolean",
"description": "Whether the task is billable."
},
"due_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Due date."
},
"priority": {
"anyOf": [
{
"type": "number",
"const": 25
},
{
"type": "number",
"const": 50
},
{
"type": "number",
"const": 75
},
{
"type": "number",
"const": 100
}
],
"description": "Priority: 25 low, 50 normal, 75 high, 100 critical."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Project to add the task to (used when tasklist_id is not given).",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"description": "Task description / notes."
},
"tasklist_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Task list to add the task to.",
"exclusiveMinimum": 0
},
"budget_hours": {
"type": "number",
"minimum": 0,
"description": "Budget hours for the task."
}
}
},
"annotations": {
"title": "Create a task",
"destructiveHint": true
}
}Update a task — rename, re-describe, reassign (users replaces the whole list), set due date or priority, mark complete/incomplete, move to another task list or workflow status. Only the fields given are changed. Paymo: PUT /api/tasks/{id}.
| Parameter | Type | Description |
|---|---|---|
| name | string | New name. |
| users | array | New FULL list of assignee user ids. |
| task_id * | integer | The task id. |
| complete | boolean | true = mark complete, false = reopen. |
| due_date | string | New due date. |
| priority | any | Priority: 25 low, 50 normal, 75 high, 100 critical. |
| status_id | integer | Workflow status id. |
| description | string | New description. |
| tasklist_id | integer | Move to this task list. |
| budget_hours | number | New budget hours. |
Log a completed time entry on a task, EITHER as date + duration_seconds OR as start_time + end_time (min 1 minute). To start a live timer use paymo_start_timer. Paymo: POST /api/entries.
| Parameter | Type | Description |
|---|---|---|
| date | string | Day of the entry (with duration_seconds). |
| task_id * | integer | Task the time is for. |
| user_id | integer | User to log the time for (default: the API key's user). |
| end_time | string | End (with start_time). |
| start_time | string | Start (with end_time). |
| description | string | What was done. |
| duration_seconds | integer | Length in seconds (with date), e.g. 3600 = 1h. |
{
"name": "paymo_create_time_entry",
"title": "Log time",
"description": "Log a completed time entry on a task, EITHER as date + duration_seconds OR as start_time + end_time (min 1 minute). To start a live timer use paymo_start_timer. Paymo: POST /api/entries.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Day of the entry (with duration_seconds)."
},
"task_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Task the time is for.",
"exclusiveMinimum": 0
},
"user_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "User to log the time for (default: the API key's user).",
"exclusiveMinimum": 0
},
"end_time": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(Z|[+-]\\d{2}:\\d{2})$",
"description": "End (with start_time)."
},
"start_time": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(Z|[+-]\\d{2}:\\d{2})$",
"description": "Start (with end_time)."
},
"description": {
"type": "string",
"description": "What was done."
},
"duration_seconds": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Length in seconds (with date), e.g. 3600 = 1h.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Log time",
"destructiveHint": true
}
}Edit a time entry: description, task, or its length. duration_seconds only applies to date+duration entries; for start/end entries change end_time instead. Paymo: PUT /api/entries/{id}.
| Parameter | Type | Description |
|---|---|---|
| date | string | New day (date+duration entries only). |
| task_id | integer | Move the entry to this task. |
| end_time | string | New end (start/end entries only). |
| entry_id * | integer | The time entry id. |
| start_time | string | New start (start/end entries only). |
| description | string | New description. |
| duration_seconds | integer | New length in seconds (date+duration entries only). |
{
"name": "paymo_update_time_entry",
"title": "Update a time entry",
"description": "Edit a time entry: description, task, or its length. duration_seconds only applies to date+duration entries; for start/end entries change end_time instead. Paymo: PUT /api/entries/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"entry_id"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "New day (date+duration entries only)."
},
"task_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Move the entry to this task.",
"exclusiveMinimum": 0
},
"end_time": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(Z|[+-]\\d{2}:\\d{2})$",
"description": "New end (start/end entries only)."
},
"entry_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The time entry id.",
"exclusiveMinimum": 0
},
"start_time": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(Z|[+-]\\d{2}:\\d{2})$",
"description": "New start (start/end entries only)."
},
"description": {
"type": "string",
"description": "New description."
},
"duration_seconds": {
"type": "integer",
"maximum": 9007199254740991,
"description": "New length in seconds (date+duration entries only).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update a time entry",
"destructiveHint": true
}
}Start a running timer on a task (a time entry with a start_time and no end_time). A user can have only one running timer; if one is running Paymo returns 409. Paymo: POST /api/entries.
| Parameter | Type | Description |
|---|---|---|
| task_id * | integer | Task to time. |
| user_id | integer | User to start the timer for (default: the API key's user). |
| start_time | string | When the timer started (default: now). |
| description | string | What is being worked on. |
{
"name": "paymo_start_timer",
"title": "Start a timer",
"description": "Start a running timer on a task (a time entry with a start_time and no end_time). A user can have only one running timer; if one is running Paymo returns 409. Paymo: POST /api/entries.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Task to time.",
"exclusiveMinimum": 0
},
"user_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "User to start the timer for (default: the API key's user).",
"exclusiveMinimum": 0
},
"start_time": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(Z|[+-]\\d{2}:\\d{2})$",
"description": "When the timer started (default: now)."
},
"description": {
"type": "string",
"description": "What is being worked on."
}
}
},
"annotations": {
"title": "Start a timer",
"destructiveHint": true
}
}Stop a running timer by setting its end_time (default: now). The final duration must be at least 1 minute. Find running timers with paymo_list_time_entries running_only=true. Paymo: PUT /api/entries/{id}.
| Parameter | Type | Description |
|---|---|---|
| end_time | string | When the timer stopped (default: now). |
| entry_id * | integer | The running timer's time-entry id. |
| description | string | Final description. |
{
"name": "paymo_stop_timer",
"title": "Stop a timer",
"description": "Stop a running timer by setting its end_time (default: now). The final duration must be at least 1 minute. Find running timers with paymo_list_time_entries running_only=true. Paymo: PUT /api/entries/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"entry_id"
],
"properties": {
"end_time": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(Z|[+-]\\d{2}:\\d{2})$",
"description": "When the timer stopped (default: now)."
},
"entry_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The running timer's time-entry id.",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"description": "Final description."
}
}
},
"annotations": {
"title": "Stop a timer",
"destructiveHint": true
}
}Add a comment to a task's discussion thread (content may contain basic HTML). Read existing comments with paymo_get_task include=thread.comments. Paymo: POST /api/comments.
| Parameter | Type | Description |
|---|---|---|
| content * | string | Comment text. |
| task_id * | integer | Task to comment on. |
{
"name": "paymo_add_task_comment",
"title": "Comment on a task",
"description": "Add a comment to a task's discussion thread (content may contain basic HTML). Read existing comments with paymo_get_task include=thread.comments. Paymo: POST /api/comments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id",
"content"
],
"properties": {
"content": {
"type": "string",
"minLength": 1,
"description": "Comment text."
},
"task_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Task to comment on.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Comment on a task",
"destructiveHint": true
}
}Tools for Paymo, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many hours did my team log last week across all projects?"; "Which tasks are overdue, and who are they assigned to?"; "Which invoices are still unpaid and for which clients?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Paymo data. Free plan: 50 tool calls per month. Run paymo_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run paymo_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run paymo_upgrade without a plan: it returns both plans, each with a payment link for the user to open. paymo_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "paymo_list_tasks",
"title": "List tasks",
"description": "List tasks (id, name, code, project_id, tasklist_id, complete, due_date, users, priority), filtered by project, task list, assignee or completion. my_tasks=true returns the caller's 'My Tasks'. Paymo: GET /api/tasks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated."
},
"where": {
"type": "string",
"maxLength": 500,
"description": "Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b)."
},
"include": {
"type": "string",
"pattern": "^[a-z_]+(\\.[a-z_]+)*(,[a-z_]+(\\.[a-z_]+)*)*$",
"maxLength": 300,
"description": "Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks."
},
"user_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only tasks assigned to this user.",
"exclusiveMinimum": 0
},
"complete": {
"type": "boolean",
"description": "true = completed tasks, false = open tasks."
},
"my_tasks": {
"type": "boolean",
"description": "true = tasks assigned to the calling user or to nobody, in their projects."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only tasks from this project.",
"exclusiveMinimum": 0
},
"tasklist_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only tasks from this task list.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List tasks",
"readOnlyHint": true
}
}| project_id |
| integer |
| Only entries from this project. |
| running_only | boolean | true = only running timers (no end_time yet). |
{
"name": "paymo_list_time_entries",
"title": "List time entries",
"description": "List time entries (id, task_id, user_id, project_id, start_time/end_time or date, duration in seconds, description, billed). At least one filter is required. from/to filter by the entry's time interval; running_only=true returns running timers. Paymo: GET /api/entries.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": "string",
"description": "Interval end (YYYY-MM-DD = end of that day UTC). Requires `from`."
},
"from": {
"type": "string",
"description": "Interval start (YYYY-MM-DD = start of that day UTC). Requires `to`."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max items to return (default 100, max 500). Paymo has no pagination; results beyond this are truncated."
},
"where": {
"type": "string",
"maxLength": 500,
"description": "Extra raw Paymo filter ANDed onto the typed ones, e.g. `billable=true` or `name like Website`. Operators: = > >= < <= != like, not like, in (a,b), not in (a,b)."
},
"billed": {
"type": "boolean",
"description": "true = already invoiced, false = unbilled."
},
"include": {
"type": "string",
"pattern": "^[a-z_]+(\\.[a-z_]+)*(,[a-z_]+(\\.[a-z_]+)*)*$",
"maxLength": 300,
"description": "Related objects to embed (Paymo `include`), comma-separated, e.g. client or tasklists.tasks."
},
"task_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only entries for this task.",
"exclusiveMinimum": 0
},
"user_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only entries for this user.",
"exclusiveMinimum": 0
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only entries for this client.",
"exclusiveMinimum": 0
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only entries from this project.",
"exclusiveMinimum": 0
},
"running_only": {
"type": "boolean",
"description": "true = only running timers (no end_time yet)."
}
}
},
"annotations": {
"title": "List time entries",
"readOnlyHint": true
}
}{
"name": "paymo_update_task",
"title": "Update a task",
"description": "Update a task — rename, re-describe, reassign (users replaces the whole list), set due date or priority, mark complete/incomplete, move to another task list or workflow status. Only the fields given are changed. Paymo: PUT /api/tasks/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "New name."
},
"users": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"description": "New FULL list of assignee user ids."
},
"task_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The task id.",
"exclusiveMinimum": 0
},
"complete": {
"type": "boolean",
"description": "true = mark complete, false = reopen."
},
"due_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "New due date."
},
"priority": {
"anyOf": [
{
"type": "number",
"const": 25
},
{
"type": "number",
"const": 50
},
{
"type": "number",
"const": 75
},
{
"type": "number",
"const": 100
}
],
"description": "Priority: 25 low, 50 normal, 75 high, 100 critical."
},
"status_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Workflow status id.",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"description": "New description."
},
"tasklist_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Move to this task list.",
"exclusiveMinimum": 0
},
"budget_hours": {
"type": "number",
"minimum": 0,
"description": "New budget hours."
}
}
},
"annotations": {
"title": "Update a task",
"destructiveHint": true
}
}