trackly-app/trackly-cli

trackly-cli

The only job tracking CLI built for AI agents.

Search 128,000+ jobs across 1,900+ companies and 40+ ATS types. Track applications, get AI-powered recommendations, and manage your job search -- from the terminal or through Claude, ChatGPT, Cursor, and other MCP-compatible AI agents.

Two ways to connect

🚀 Option 1: One-click in Claude co-work, Claude Desktop, ChatGPT (no install)

Use Trackly directly inside your AI — zero config:

• Open Settings → Connectors → Add custom connector
• URL: https://mcp.usetrackly.app/api/mcp
• Click Add → sign in with Google → done

Full setup guide with screenshots →

Works in: Claude co-work (web), Claude Desktop, ChatGPT Connectors, and any MCP client that supports remote/streamable-http connectors.

💻 Option 2: CLI install (for Cursor, Windsurf, or terminal use)

npm install -g trackly-cli    # may need: sudo npm install -g trackly-cli
trackly login
trackly jobs --function product

Prerequisites: Node.js 20+ (LTS recommended). On macOS with the official .pkg installer, global npm installs may require sudo.

At a Glance

1,900+ companies | 128K+ jobs | 40+ ATS types | CLI + MCP | 36 local MCP tools

CLI Commands

trackly jobs                          # List jobs
trackly jobs --remote                 # Filter remote jobs (sets usStates=REMOTE)
trackly jobs --region us              # Filter by region (us, non_us, all, or a region tag: europe, canada, remote, ...)
trackly jobs --job-type internship    # Filter by employment type (full_time, internship, all)
trackly jobs --work-arrangement hybrid,remote  # Filter by work arrangement independently
trackly jobs --function product       # Filter by function
trackly jobs --company 243            # Filter by company ID
trackly job 1234                      # Get job details
trackly jobs 1234                     # Alias for job details
trackly companies                     # List companies
trackly companies search "fintech"    # Semantic company search
trackly search "fintech"              # Alias for semantic company search

trackly status # Alias for stats trackly preferences # Show discovery preferences and experience limits trackly preferences experience product=2 strategy=5 # Replace role-specific limits trackly preferences experience clear # Turn role-specific experience filtering off trackly apply 1234 # Mark as applied trackly save 1234 # Save a job trackly dismiss 1234 # Dismiss a job trackly ask "PM jobs in SF" # Natural language search (20/day) trackly contacts "Stripe" # Search contacts at a company trackly brief 1234 # Get network brief for a job trackly referral start 1234 # Start a referral campaign trackly referral status 1234 # Check referral campaign status trackly company-brief 243 # Get company brief (--refresh to regenerate) trackly company-workspace 243 # Full company workspace view trackly request-company "eBay" # Request a company be added (--url, --notes optional) trackly api-key create # Generate API key trackly api-key list # List API keys trackly config # Show current CLI config trackly config --api-key trkxxx # Save an API key for future commands trackly version # Show installed version trackly whoami # Show current user trackly logout # Clear credentials trackly agent setup --client both # Install Trackly Apply for Codex + Claude Code trackly agent doctor # Verify setup, profile, resume, and compatibility

Add `--json` to any command for JSON output. Use `--api-key <key>` or `--base-url <url>` as one-off global flags when needed.

`trackly preferences --json` returns only `success`, `experienceFilterV2Available`, and `preferences`. The availability flag controls whether this client may edit role-specific limits; it does not claim that feed or alert enforcement is active. Every update checks that flag and the latest preference revision before writing.

## MCP Server Setup

### Hosted (Claude co-work, Claude Desktop, ChatGPT)

No install. In your AI tool, open **Settings → Connectors → Add custom connector** and enter: