Run saved query
Runs a saved query and returns its rows.
MCP tool peoplehr_read → run_query
read
Returns the columns of the query and its rows as PeopleHR shows them, the same data the Export to CSV button gives. Dates keep the format PeopleHR uses in the result. It reads only and changes nothing.
Parameters
| Name | Type | Description |
|---|---|---|
| name string required | string | Exact name from list_queries. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "peoplehr_read",
"arguments": {
"operation": "run_query",
"arguments": {
"name": "Jane Doe"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"name": "Probation ending soon",
"columns": [
"Employee",
"Probation End Date",
"Probation Status"
],
"rows": [
[
"Ana Lopez",
"2027-02-16",
"In probation"
],
[
"Jake Ortiz",
"2026-12-04",
"In probation"
]
],
"next_cursor": null
},
"isError": false
}