# Paymo MCP by usefulapi

> Paymo MCP by usefulapi is an MCP server. Browse Paymo projects, tasks, timesheets and invoices, and create tasks, log time or run timers. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/paymo/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/paymo
- **MCP Registry name:** io.usefulapi/paymo
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://paymo.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "paymo": {
      "url": "https://paymo.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/paymo-mcp-by-usefulapi
