Search Everhour tasks
everhour_search_tasksSearch Everhour tasks by name to find Asana-synced tasks. Optionally scope by project ID for targeted results.
Instructions
Search tasks in Everhour by name, optionally scoped to a project.
This is the primary way to find an Everhour task that mirrors an Asana ticket when you only know the ticket name. Asana-synced tasks appear with IDs like 'as:'.
Args:
query (string): Search string, 1-200 chars
project_id (string, optional): Scope search to this Everhour project ID
limit, offset: Pagination (default limit=25, max 250)
response_format ('markdown' | 'json'): Output format
Returns: { "total": number, "count": number, "offset": number, "items": [{ "id": "as:...", "name": string, "url": string, "status"?: string, "projects"?: string[] }], "has_more": boolean, "next_offset"?: number }
Examples:
"Find Everhour task for 'Fix login bug'" → query='Fix login bug'
"Find all design review tasks in project as:120801..." → query='design review', project_id='as:120801...'
Error Handling:
400 → query is empty
429 → rate-limited
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results to return (1-250, default 25) | |
| query | Yes | Search string. Matches task name and (for synced tasks) the source platform's task name. Examples: 'login bug', 'OPS-123'. | |
| offset | No | Number of results to skip for pagination (default 0) | |
| project_id | No | Optional Everhour project ID to scope the search (e.g. 'as:120801...'). | |
| response_format | No | Output format: 'markdown' for human-readable text or 'json' for machine-readable structured data | markdown |