AI & MCP: connect Claude, Codex or Cursor

Connect ClearTract to Claude, ChatGPT's Codex or Cursor so your assistant can read your lists, search projects and draft outreach for you. In beta.

ClearTract connects to AI assistants through MCP, a standard way for assistants to use outside tools. Once connected, you can ask about your projects in plain English and your assistant looks them up in ClearTract.

This is in beta. Tell us what’s confusing, missing or wrong at [email protected], especially if anything doesn’t match what you see in the app.

Connect Claude

You’ll need: your ClearTract login (the same one you use for the app) and Claude on a plan that supports custom connectors (Pro, Team or Enterprise).

1. In Claude, go to Settings → Connectors → Add custom connector.

2. Enter ClearTract as the name and this as the URL, then click Add:

   https://app.cleartract.ai/api/mcp

3. Click Connect. You’ll be sent to the ClearTract sign-in. Log in with your normal account and approve access. You only do this once; Claude stays connected after.

To use it in a chat, make sure ClearTract is turned on in the tools menu under the message box.

Connect Codex (ChatGPT)

In the Codex desktop app:

1. Open Settings → Plugins and choose Add MCP Server.

2. On Connect to a custom MCP, enter cleartract as the name (no dots or spaces).

3. Next to Type, choose Streamable HTTP, then paste the URL:

   https://app.cleartract.ai/api/mcp

4. Save. In the MCPs list, click Authenticate next to cleartract.

5. In the browser, click Continue to sign in, then log in with your ClearTract account.

Codex’s desktop app, command line and editor extension share the same settings, so this works in all three. Prefer the command line? Run codex mcp add cleartract --url https://app.cleartract.ai/api/mcp, then codex mcp login cleartract.

Connect Cursor

1. In Cursor, click Customize in the sidebar, open the MCPs tab, and click New MCP Server. This opens your mcp.json file.

2. Replace its contents with the following and save:

   {
     "mcpServers": {
       "cleartract": { "url": "https://app.cleartract.ai/api/mcp" }
     }
   }

   Already have other servers in there? Add just the "cleartract" line inside mcpServers.

3. Back in Customize → MCPs, cleartract shows under Needs Attention. Click Authenticate.

4. In the browser, click Continue to sign in, then log in with your ClearTract account.

5. Start a New Chat and ask away.

Try it

Just ask in plain English:

• “List my ClearTract lists”
• “Show the projects in my [list name] list”
• “Give me the full detail on [project or address]”
• “Who’s the general contractor on [project]?”
• “Write an outreach brief for [project]”
• “Find tenant improvement projects in Orange County filed this month”
• “Add [project] to my [list name] list”

More ideas: AI prompts that get results.

What it can see and do

• Your lists: your lists and the projects in them, including each project’s permits and cases, the people and companies on it (with their roles and which permits they’re on), the timeline of milestones, and any research notes.
• Search all projects: look across everything ClearTract tracks, not just your lists.
• Edit lists: add projects to, or remove them from, lists you own or lists your team shares. Adding a project to a list also saves it to your Saved list, just like in the app. Your assistant should check with you before removing anything.

It can’t change anything else: no editing projects, contacts or account settings. Data refreshes about every 2 hours.

Other AI assistants

The same address may work in other assistants that support MCP, such as VS Code with GitHub Copilot or Gemini CLI. We haven’t tested those yet. If you try one, tell us how it goes at [email protected] and we’ll add step-by-step instructions here.