• DATA
  • REPORTS
  • ANALYSIS
  • HUMAN

How to run custom CZQL queries with your AI

Connect your AI to AdaptiveWork to turn plain English into precise Clarizen Query Language commands. You get the data you need without writing code.

Ask AI about this page

Short answer

How can I run CZQL queries using my AI?

Your AI uses the run_query tool to translate your requests into CZQL commands. This pulls specific project or resource datasets from AdaptiveWork. You'll see the results as text or tables in your chat.

Query outcomes

What you get back

The specific data your AI pulls from AdaptiveWork.

DATA

Raw datasets

The AI pulls specific rows and columns based on your request. You get the exact information you asked for in a readable format.

REPORTS

Project views

Ask for filtered views like overdue tasks or resource loads. The AI fetches these specific snapshots from Clarizen.

ANALYSIS

Summarized findings

Once the data is pulled, your AI can highlight trends or outliers. It turns the raw query results into useful observations.

HUMAN

Final verification

The AI provides the data, but you check the results. You decide if the query captured exactly what you needed for your report.

The workflow

What your AI does when a query arrives.

The AI handles the technical translation so you don't have to touch the Clarizen query builder.

  1. Translate intent

    Your AI interprets your plain English request and maps it to the correct CZQL syntax.

    run_query

  2. Execute command

    The agent sends the formatted query to AdaptiveWork to fetch the requested records.

    run_query

  3. Format results

    The AI takes the raw data returned from the query and organizes it into a readable format.

    run_query

  4. Present findings

    The data is delivered to your chat window, ready for you to use or analyze further.

    run_query

Try it

Copy these to start.

Use these prompts to test the connection.

Starting points

These are opening lines. Swap the bracketed text for your actual project names or user IDs.

AdaptiveWork Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_TeW7IQPO8SIFovBzrGn3Ua8sgdMlfkxQwTWae87b/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — AdaptiveWork capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "adaptivework-clarizen-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_TeW7IQPO8SIFovBzrGn3Ua8sgdMlfkxQwTWae87b/mcp"
    }
  }
}
Copy into chat04

  • Run a query to show all high priority tasks in the [Project Name] project.

  • Find all overdue tasks assigned to [User Name] in Clarizen.

  • List all projects in [Project Name] that have a status of 'In Progress'.

  • Show me the resource load for [User Name] for the next two weeks.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect AdaptiveWork once, then ask.

Link your account through the Vinkius dashboard. Your credentials stay encrypted, and you can start querying immediately in your preferred AI client.

Connect AdaptiveWork to your AI

FAQ

How this task behaves

  • 01

    Can the AI change project data using these queries?

    No. The run_query tool is strictly for pulling data. It cannot update, delete, or create records in AdaptiveWork.

  • 02

    Does the AI write the CZQL code itself?

    Yes. The AI translates your natural language into the specific CZQL syntax required by Clarizen.

  • 03

    Can I run queries on any field in Clarizen?

    Yes, as long as the field is accessible via the Clarizen API and part of the data schema the AI can see.

  • 04

    Will the AI delete my projects if I ask it to?

    No. This connector only has the capability to run queries. It has no tools for deleting or modifying your data.

  • 05

    Do I need to know CZQL to use this?

    No. You just talk to your AI like a person, and it handles the technical query language for you.

  • More questions about AdaptiveWork? See everything the AdaptiveWork Connector can do

Connect AdaptiveWork to Claude, Cursor, ChatGPT & more