104.com.tw MCP Server

MCP server for Taiwan's largest job platform — search jobs, browse companies, and apply, all from Claude.

Disclaimer: This project is not affiliated with or endorsed by 104 Human Resources Group (104人力銀行). Use in accordance with 104.com.tw's Terms of Service.

Tools

Tool	Auth required	Description
search_jobs	No	Search job listings by keyword, location, salary, remote, etc.
get_job_detail	No	Full job posting: description, salary, requirements, welfare
search_companies	No	Search companies by name
get_company_detail	No	Company profile + optional current job listings
login	—	Log in with email/password
logout	—	Log out
apply_job	Yes	Apply to a job with optional cover letter
save_job	Yes	Bookmark a job
save_company	Yes	Follow a company

npm package name

This repository publishes mcp-104jobs (see package.json). That is the package to install and the binary name for MCP clients.

If you see 104-mcp-server on npm as well, it is the same project published under an older alternate name. Prefer mcp-104jobs; the duplicate can be marked deprecated on npm by its owner (npm deprecate 104-mcp-server@"*" "Use mcp-104jobs instead").

Setup

Via npx (recommended)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "104": {
      "command": "npx",
      "args": ["-y", "mcp-104jobs"]
    }
  }
}

Manual

npm install
npm run build

Add to Claude Desktop config:

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

Usage examples

• "Search for backend engineer jobs in Taipei with remote work"
• "Show me the details for job 8tft1"
• "Search for companies named Google in Taiwan"
• "Get the company profile for 1a2x6bmutz including their job openings"
• "Login with my 104 account and apply to job 8kq2g"

Location codes

Code	Area
6001001000	台北市
6001002000	新北市
6001003000	桃園市
6001005000	台中市
6001006000	台南市
6001008000	高雄市

Compatible clients

Works with any MCP-compatible AI client:

Client	Config file
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json
Cursor	~/.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
Cline (VS Code)	MCP Servers panel in sidebar
Continue.dev	~/.continue/config.json → mcpServers
Zed	settings.json → context_servers

All clients use the same config block:

{
  "mcpServers": {
    "104": {
      "command": "npx",
      "args": ["-y", "mcp-104jobs"]
    }
  }
}

ChatGPT / GPT Actions

A REST API is deployed at https://104-mcp.vercel.app for use as a GPT Action.

OpenAPI spec: https://104-mcp.vercel.app/openapi.json

To add to a Custom GPT:

1. Go to chat.openai.com/gpts → Create
2. Click Configure → Add actions
3. Paste the OpenAPI spec URL above
4. Save and test

Available via GPT Actions (read-only, no auth required):

• searchJobs — search job listings
• getJobDetail — full job posting
• searchCompanies — search companies
• getCompanyDetail — company profile

Notes

• No API key needed for read-only tools
• Auth uses 104's OIDC discovery flow (Ory Hydra with PKCE). Tokens and cookies are held only in memory for the lifetime of the local MCP process; expiring access tokens are refreshed when 104 issues a refresh token.
• Apply/save require a valid 104.com.tw account