ProofHub MCP by usefulapi is an MCP server published by io.usefulapi, hosted at proofhub.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 15 tools, including proofhub_list_projects, proofhub_get_project, proofhub_list_todolists, proofhub_list_tasks, proofhub_get_task.
Read projects, tasks, comments, people and time entries; create tasks and comments in ProofHub.
4,164 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.
List all projects in the ProofHub account the key belongs to. Start here to find project ids. GET /projects.
No parameters.
{
"name": "proofhub_list_projects",
"title": "List projects",
"description": "List all projects in the ProofHub account the key belongs to. Start here to find project ids. GET /projects.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List projects",
"readOnlyHint": true
}
}Get one project by id: name, status, dates and the people on it. GET /projects/{project_id}.
| Parameter | Type | Description |
|---|---|---|
| project_id * | any |
{
"name": "proofhub_get_project",
"title": "Get project",
"description": "Get one project by id: name, status, dates and the people on it. GET /projects/{project_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id"
],
"properties": {
"project_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
}
}
},
"annotations": {
"title": "Get project",
"readOnlyHint": true
}
}List the to-do lists (task lists) of one project. GET /projects/{project_id}/todolists.
| Parameter | Type | Description |
|---|---|---|
| project_id * | any |
{
"name": "proofhub_list_todolists",
"title": "List to-do lists",
"description": "List the to-do lists (task lists) of one project. GET /projects/{project_id}/todolists.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id"
],
"properties": {
"project_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
}
}
},
"annotations": {
"title": "List to-do lists",
"readOnlyHint": true
}
}List the tasks of one to-do list with title, assignees, labels, dates and completion. GET /projects/{project_id}/todolists/{todolist_id}/tasks.
| Parameter | Type | Description |
|---|---|---|
| project_id * | any | |
| todolist_id * | any |
{
"name": "proofhub_list_tasks",
"title": "List tasks in a to-do list",
"description": "List the tasks of one to-do list with title, assignees, labels, dates and completion. GET /projects/{project_id}/todolists/{todolist_id}/tasks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id",
"todolist_id"
],
"properties": {
"project_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"todolist_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
}
}
},
"annotations": {
"title": "List tasks in a to-do list",
"readOnlyHint": true
}
}Get one task with its description, dates, assignees, labels and progress. GET /projects/{project_id}/todolists/{todolist_id}/tasks/{task_id}.
| Parameter | Type | Description |
|---|---|---|
| task_id * | any | |
| project_id * | any | |
| todolist_id * | any |
{
"name": "proofhub_get_task",
"title": "Get task",
"description": "Get one task with its description, dates, assignees, labels and progress. GET /projects/{project_id}/todolists/{todolist_id}/tasks/{task_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id",
"todolist_id",
"task_id"
],
"properties": {
"task_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"project_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"todolist_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
}
}
},
"annotations": {
"title": "Get task",
"readOnlyHint": true
}
}List the comments on one task. GET /projects/{project_id}/todolists/{todolist_id}/tasks/{task_id}/comments.
| Parameter | Type | Description |
|---|---|---|
| task_id * | any | |
| project_id * | any | |
| todolist_id * | any |
{
"name": "proofhub_list_task_comments",
"title": "List task comments",
"description": "List the comments on one task. GET /projects/{project_id}/todolists/{todolist_id}/tasks/{task_id}/comments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id",
"todolist_id",
"task_id"
],
"properties": {
"task_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"project_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"todolist_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
}
}
},
"annotations": {
"title": "List task comments",
"readOnlyHint": true
}
}List tasks across the whole account, filtered by project, label or completion. Paged: when the reply has more records, call again with a higher start. GET /alltodo.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Records per page, 1 to 100 (default 100). |
| start | integer | Offset of the first record (default 0). |
| labels | string | Comma-separated numeric ids. |
| projects | string | Comma-separated numeric ids. |
| completed | boolean | true for completed tasks only, false for open tasks only. |
{
"name": "proofhub_search_all_tasks",
"title": "Search tasks across projects",
"description": "List tasks across the whole account, filtered by project, label or completion. Paged: when the reply has more records, call again with a higher start. GET /alltodo.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Records per page, 1 to 100 (default 100)."
},
"start": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Offset of the first record (default 0)."
},
"labels": {
"type": "string",
"pattern": "^\\d+(,\\d+)*$",
"description": "Comma-separated numeric ids."
},
"projects": {
"type": "string",
"pattern": "^\\d+(,\\d+)*$",
"description": "Comma-separated numeric ids."
},
"completed": {
"type": "boolean",
"description": "true for completed tasks only, false for open tasks only."
}
}
},
"annotations": {
"title": "Search tasks across projects",
"readOnlyHint": true
}
}List the discussion topics of one project. GET /projects/{project_id}/topics.
| Parameter | Type | Description |
|---|---|---|
| project_id * | any |
{
"name": "proofhub_list_topics",
"title": "List discussion topics",
"description": "List the discussion topics of one project. GET /projects/{project_id}/topics.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id"
],
"properties": {
"project_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
}
}
},
"annotations": {
"title": "List discussion topics",
"readOnlyHint": true
}
}List the task labels of the account. Use the ids in task filters. GET /labels.
No parameters.
{
"name": "proofhub_list_labels",
"title": "List labels",
"description": "List the task labels of the account. Use the ids in task filters. GET /labels.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List labels",
"readOnlyHint": true
}
}List the people (users) of the account with their roles and emails. GET /people.
No parameters.
{
"name": "proofhub_list_people",
"title": "List people",
"description": "List the people (users) of the account with their roles and emails. GET /people.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List people",
"readOnlyHint": true
}
}Get one person by id. GET /people/{person_id}.
| Parameter | Type | Description |
|---|---|---|
| person_id * | any |
{
"name": "proofhub_get_person",
"title": "Get person",
"description": "Get one person by id. GET /people/{person_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"person_id"
],
"properties": {
"person_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
}
}
},
"annotations": {
"title": "Get person",
"readOnlyHint": true
}
}List logged time entries across the account, paged. When the reply is full, call again with a higher start. GET /alltime.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Records per page, 1 to 100 (default 100). |
| start | integer | Offset of the first record (default 0). |
{
"name": "proofhub_list_time_entries",
"title": "List time entries",
"description": "List logged time entries across the account, paged. When the reply is full, call again with a higher start. GET /alltime.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Records per page, 1 to 100 (default 100)."
},
"start": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Offset of the first record (default 0)."
}
}
},
"annotations": {
"title": "List time entries",
"readOnlyHint": true
}
}Create a task in a to-do list. Writes to the account. Each call makes a new task, so do not retry blindly. POST /projects/{project_id}/todolists/{todolist_id}/tasks.
| Parameter | Type | Description |
|---|---|---|
| title * | string | Task title. |
| labels | array | Label ids (from proofhub_list_labels). |
| assigned | array | Person ids to assign (from proofhub_list_people). |
| due_date | string | |
| project_id * | any | |
| start_date | string | |
| description | string | |
| todolist_id * | any |
{
"name": "proofhub_create_task",
"title": "Create task",
"description": "Create a task in a to-do list. Writes to the account. Each call makes a new task, so do not retry blindly. POST /projects/{project_id}/todolists/{todolist_id}/tasks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id",
"todolist_id",
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Task title."
},
"labels": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"maxItems": 50,
"description": "Label ids (from proofhub_list_labels)."
},
"assigned": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"maxItems": 50,
"description": "Person ids to assign (from proofhub_list_people)."
},
"due_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"project_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"description": {
"type": "string",
"maxLength": 20000
},
"todolist_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
}
}
},
"annotations": {
"title": "Create task",
"destructiveHint": true
}
}Mark one task completed (true) or open again (false). Setting the same value twice is harmless. PUT /projects/{project_id}/todolists/{todolist_id}/tasks/{task_id}.
| Parameter | Type | Description |
|---|---|---|
| task_id * | any | |
| completed * | boolean | |
| project_id * | any | |
| todolist_id * | any |
{
"name": "proofhub_set_task_completed",
"title": "Mark task complete or open",
"description": "Mark one task completed (true) or open again (false). Setting the same value twice is harmless. PUT /projects/{project_id}/todolists/{todolist_id}/tasks/{task_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id",
"todolist_id",
"task_id",
"completed"
],
"properties": {
"task_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"completed": {
"type": "boolean"
},
"project_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"todolist_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
}
}
},
"annotations": {
"title": "Mark task complete or open",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Post a comment on one task, as the key's user. Each call posts a new comment, so do not retry blindly. POST /projects/{project_id}/todolists/{todolist_id}/tasks/{task_id}/comments.
| Parameter | Type | Description |
|---|---|---|
| task_id * | any | |
| project_id * | any | |
| description * | string | Comment text. |
| todolist_id * | any |
{
"name": "proofhub_add_task_comment",
"title": "Add task comment",
"description": "Post a comment on one task, as the key's user. Each call posts a new comment, so do not retry blindly. POST /projects/{project_id}/todolists/{todolist_id}/tasks/{task_id}/comments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id",
"todolist_id",
"task_id",
"description"
],
"properties": {
"task_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"project_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"description": {
"type": "string",
"maxLength": 20000,
"minLength": 1,
"description": "Comment text."
},
"todolist_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
}
}
},
"annotations": {
"title": "Add task comment",
"destructiveHint": true
}
}Tools for ProofHub, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which tasks in our Website Redesign project are overdue?"; "List the open tasks assigned to Maria across all projects."; "Create a task 'Send final invoice' in the Finance to-do list, due on 2026-11-30.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes ProofHub data. Free plan: 50 tool calls per month. Run proofhub_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 proofhub_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 proofhub_upgrade without a plan: it returns both plans, each with a payment link for the user to open. proofhub_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.