AU Jobs

A Model Context Protocol (MCP) server that lets Claude search and track jobs across Australia's major job platforms — built for anyone hunting part-time or full-time work in Australia.

Platforms Covered

Platform	Best for
Seek.com.au	Australia's largest job board — most employers post here first
Jora.com.au	Aggregates Indeed + CareerJet + others — great for hospitality & retail
Gumtree.com.au	Local casual, trade, and driver jobs

Tools

Tool	Description
search_jobs	Search Seek by keyword, location, salary, work type
get_job_details	Fetch full job description from Seek, Jora, or Gumtree
search_jora	Search Jora by keyword, location, salary, work type
search_gumtree	Search Gumtree jobs by keyword and state
search_all	Search all three platforms at once
save_job	Save a job from any platform to your local tracker
update_application	Update status: saved → applied → interviewing → offer / rejected
list_saved_jobs	View all tracked jobs, filterable by status
find_new_jobs	Re-run a search across all platforms and return only new listings since last check
update_profile	Store applicant details (availability, work rights, experience) used when drafting applications
apply_queue	Save a batch of jobs and get a ready-to-apply list with direct apply links, highest pay first
draft_application	Pull a job's full description + your profile so Claude can draft a tailored cover note and screening answers

Pay-first ranking

Every search parses salary strings ("$35 – $48 per hour", "$70k p.a.") into a normalized hourly estimate and returns results highest estimated pay first (pass sortBy: "relevance" for the site's own order). Salary filters accept either hourly rates (values under 200) or annual salaries, and location defaults to Adelaide SA when omitted.

Requirements

• Node.js 18+
• Claude Desktop

Setup

git clone https://github.com/HimashaHerath/au-jobs-mcp.git
cd au-jobs-mcp
npm install
npx playwright install chromium
npm run build

Connect to Claude Desktop

Add the following to your Claude Desktop config file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "au-jobs": {
      "command": "node",
      "args": ["/absolute/path/to/au-jobs-mcp/dist/index.js"]
    }
  }
}

Restart Claude Desktop. The tools will appear automatically.

Example Usage

Once connected, just talk to Claude naturally:

• "Search for part-time barista jobs paying at least $35/hr"
• "Search all platforms for retail jobs in Adelaide"
• "Show me the full description for Seek job 91576706"
• "Save that job and mark it as applied"
• "What jobs have I applied to?"
• "Any new kitchen hand jobs since yesterday?"

Data Storage

Saved jobs and application status are stored locally in data/jobs.db (SQLite). Nothing leaves your machine.

Project Structure

src/
├── index.ts           # MCP server + all tool handlers
├── scraper.ts         # Seek scraper (Playwright + stealth)
├── scraper_jora.ts    # Jora scraper
├── scraper_gumtree.ts # Gumtree scraper
├── salary.ts          # Salary parsing + hourly-rate ranking
├── store.ts           # SQLite job tracker
└── types.ts           # Shared types
data/
└── jobs.db            # Local job tracker (created on first run)

Tech Stack

• MCP TypeScript SDK
• Playwright + playwright-extra stealth
• better-sqlite3
• Zod