Skip to content
MCP server

Paymo MCP by usefulapi

Browse Paymo projects, tasks, timesheets and invoices, and create tasks, log time or run…

Install
Runs
Remotely
Version
1.40.0
Listing updated
4 days ago

About Paymo MCP by usefulapi

Paymo MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Browse Paymo projects, tasks, timesheets and invoices, and create tasks, log time or run timers.

Install

Run in a terminal

claude mcp add --transport http paymo https://paymo.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://paymo.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "paymo": {
      "url": "https://paymo.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "paymo": {
      "type": "http",
      "url": "https://paymo.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "paymo": {
      "serverUrl": "https://paymo.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "paymo": {
      "type": "http",
      "url": "https://paymo.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (21)

Read directly from the server.

paymo_get_me
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.
paymo_get_company
Fetch the company (account) info and settings: name, default currency, timezone, working days, invoice numbering. Paymo: GET /api/company.
paymo_list_users
List users in the company (id, name, email, type, hourly rate, assigned/managed projects). Paymo: GET /api/users.
paymo_list_clients
List clients (id, name, contact details, active flag). Paymo: GET /api/clients.
paymo_list_projects
List projects (id, name, code, client_id, active, billable, budget_hours, users, managers), optionally filtered. Paymo: GET /api/projects.
paymo_get_project
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}.
paymo_list_tasklists
List task lists (id, name, project_id, milestone_id), e.g. to pick a tasklist_id when creating a task. Paymo: GET /api/tasklists.
paymo_list_tasks
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.
paymo_get_task
Fetch one task, optionally with related objects: include=thread.comments for its comments, subtasks, entries (time logged), files, project. Paymo: GET /api/tasks/{id}.
paymo_list_time_entries
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.
paymo_list_invoices
List invoices (id, number, client_id, status, currency, date, due_date, subtotal, total). Paymo: GET /api/invoices.
paymo_get_invoice
Fetch one invoice with totals, and (by default) its line items and payments. Paymo: GET /api/invoices/{id}?include=invoiceitems,invoicepayments.
paymo_list_expenses
List expenses (id, client_id, project_id, user_id, amount, currency, date, notes, invoiced, tags). Paymo: GET /api/expenses.
paymo_create_project
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.
paymo_create_task
Create a task in a task list (tasklist_id) or a project (project_id — goes to its 'Default Task List'). Paymo: POST /api/tasks.
paymo_update_task
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}.
paymo_create_time_entry
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.
paymo_update_time_entry
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}.
paymo_start_timer
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.
paymo_stop_timer
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}.
paymo_add_task_comment
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.

Paymo MCP by usefulapi FAQ

How do I add Paymo MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http paymo https://paymo.usefulapi.io/mcp