MCP server
Paymo MCP by usefulapi
Browse Paymo projects, tasks, timesheets and invoices, and create tasks, log time or run…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://paymo.usefulapi.io/mcpInstall 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