Toggl Track ACTION
Search Detailed Time Entries
Search workspace-wide Toggl Track time entries with structured filters and provider-computed totals. Follows Toggl Reports API cursors up to an explicit cap and returns deterministic JSON without model rewriting. Only present the entries as a complete report when
complete is true; otherwise use Export Detailed Time Entries. For time per task on one project, use Get Project Task Time Summary. Results are limited by the connected user's Toggl permissions. See the documentation- Action
- Read only
- API key
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Toggl Track account once, then configure and run Search Detailed Time Entries from your backend or agent.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "toggl-search-detailed-time-entries",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
toggl: { authProvisionId: "apn_xxxxxxx" },
workspaceId: 10,
datePreset: "Date Preset",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "toggl-search-detailed-time-entries",
"configured_props": {
"toggl": { "authProvisionId": "apn_xxxxxxx" },
"workspaceId": 10,
"datePreset": "Date Preset"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "toggl",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "toggl-search-detailed-time-entries",
arguments: {
workspaceId: 10,
datePreset: "Date Preset",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
workspaceId Workspace ID | integer | The Toggl Track workspace ID, e.g. 1234567. Use List Workspace ID Options to find accessible workspace IDs. Required Dynamic |
datePreset Date Preset | string | Optional report range resolved using the connected user's Toggl timezone and first day of week, e.g. last_month. For all-user reports, Toggl evaluates dates in each time entry creator's profile timezone. Optional |
startDate Start Date | string | Inclusive report start date in YYYY-MM-DD format, e.g. 2026-09-01. Required with End Date when Date Preset is not used. Optional |
endDate End Date | string | Inclusive report end date in YYYY-MM-DD format, e.g. 2026-09-30. It may be the same as Start Date. Optional |
timezone Preset Timezone | string | Optional IANA timezone used to resolve Date Preset, e.g. America/Chicago. Defaults to the connected user's Toggl profile timezone. Optional |
userIds User IDs | integer[] | Return entries for these user IDs, subject to the connected user's Toggl permissions, e.g. [1234567]. Use List Workspace Users and its userId field to find accessible IDs. Optional |
userName User Name or Email | string | Optional full or partial name or email, e.g. Angus. It must resolve to exactly one accessible workspace user. The resolved ID is combined with User IDs. Optional |
projectIds Project IDs | integer[] | Include only these project IDs, e.g. [123456789]. Find IDs in Toggl Track project settings or the workspace projects API. Optional |
clientIds Client IDs | integer[] | Include only these client IDs, e.g. [12345678]. Find IDs in Toggl Track client settings or the workspace clients API. Optional |
taskIds Task IDs | integer[] | Include only these task IDs, e.g. [12345678]. Find IDs in Toggl Track project tasks or the workspace tasks API. Optional |
tagIds Tag IDs | integer[] | Include only entries with these tag IDs, e.g. [1234567]. Find IDs in Toggl Track workspace settings or the workspace tags API. Optional |
description Description Filter | string | Include entries whose description matches this value, e.g. weekly planning. Optional |
billable Billable | boolean | Filter entries by billable status, e.g. true. This filter requires the corresponding Toggl feature. Optional |
pageSize Page Size | integer | Number of rows requested from Toggl per API call, e.g. 50. Toggl returns no continuation cursor for single-row pages, so the action requests at least 2 rows per call (the last page may take the total one row past Maximum Results). Required |
maxResults Maximum Results | integer | Maximum rows returned across all server-side pages, e.g. 1000. If reached before Toggl is exhausted, capHit and hasMore are true and totalCount is null. Required |
cursor Cursor | object | Optional nextCursor object returned by a previous run, e.g. {"firstId": 123, "firstRowNumber": 51}. Paging uses only firstRowNumber; keep the same filters and ordering as that run. Optional |
fields Fields | string[] | Raw Toggl fields to return, e.g. ["user_id", "seconds"]. The slim default omits descriptions. Select All Fields for the complete API rows. Required |
orderBy Order By | string | Field used to order results, for example date. Date ordering is recommended for repeatable report pulls. Required |
orderDirection Order Direction | string | Direction used to order report rows, e.g. ASC. Required |
firstId Legacy First ID | integer | Deprecated. Prefer Cursor. The nextCursor.firstId value from an earlier action version, e.g. 1234567890. Optional |
firstRowNumber Legacy First Row Number | integer | Deprecated. Prefer Cursor. The nextCursor.firstRowNumber value from an earlier action version, e.g. 50. Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- toggl-search-detailed-time-entries
- Version
- 1.0.1
- App
- Toggl Track
- Authentication
- API key
- Read-only
- Yes
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗