Search global job listings, tailor resumes, draft cover letters, and track applications through an AI client.
Also known as workopia/workopia-mcp, workopia-mcp, @shuang_workopia/workopia-mcp
- Stars
- 312
- Tools
- 5
- Downloads, 30 days
- —
- Latest version
- 1.0.1
- Last commit
- Aug 31, 2026
- License
- MIT
What is Workopia MCP?
Workopia searches global job listings, tailor resumes, draft cover letters, and track applications through an AI client. It exposes 5 tools, such as job_tool, job_detail_tool, tailor_resume_tool.
Summary generated from the project's README
About Workopia MCP server
Managing your job search and application materials from inside an AI client is what Workopia enables for job seekers. By connecting to Claude Desktop, Cursor, Windsurf, or Claude Code, you can search millions of live job listings across more than 90 countries. The server pulls data from employer career pages and various applicant tracking systems like Greenhouse, Lever, and Workday.
Users interact with the server through a hosted HTTP connection using OAuth 2.0 for authentication, which removes the need to manage manual API keys. Once you sign in via your browser using Google, LinkedIn, GitHub, or an email code, you can use specific tools to find job details, save listings, and manage your progress. While the server provides the data and structure, the actual intelligence for tailoring resumes and drafting cover letters is performed by your own local AI model.
Everything you do is synced to a central Workopia profile. This allows you to access your saved jobs, tailored resumes, and application history through the dashboard tool across different supported clients.
What you can do with it
- 1Find global employment opportunitiesSearch for millions of live job listings across 90+ countries using the job search tool.
- 2Customize application documentsAsk your AI client to rewrite your resume or write a cover letter for a specific job description.
- 3Monitor your application progressAccess your saved jobs and application history through a unified dashboard.
- 4Analyze specific job requirementsRetrieve comprehensive details including salary and required skills for a single role.
Written from the project's README. Every use case is checked against a quote from it.
How to install Workopia MCP
Formats verified 10 Nov 2026Install Workopia MCP in Claude Code
$ claude mcp add workopia-mcp -- npx -y @shuang_workopia/workopia-mcpInstall Workopia MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"workopia-mcp": {
"command": "npx",
"args": [
"-y",
"@shuang_workopia/workopia-mcp"
]
}
}
}Install Workopia MCP in VS Code
.vscode/mcp.json
{
"servers": {
"workopia-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@shuang_workopia/workopia-mcp"
]
}
}
}Install Workopia MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"workopia-mcp": {
"command": "npx",
"args": [
"-y",
"@shuang_workopia/workopia-mcp"
]
}
}
}Install Workopia MCP in Codex
~/.codex/config.toml
[mcp_servers.workopia-mcp] command = "npx" args = ["-y", "@shuang_workopia/workopia-mcp"]
Install Workopia MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"workopia-mcp": {
"command": "npx",
"args": [
"-y",
"@shuang_workopia/workopia-mcp"
]
}
}
}Workopia MCP tools 5
Detected from the READMEjob_tooljob_detail_tooltailor_resume_toolcover_letter_tooldashboard_tool
| job_tool | — | |
| job_detail_tool | — | |
| tailor_resume_tool | — | |
| cover_letter_tool | — | |
| dashboard_tool | — |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubWorkopia MCP Server
Job search, resume tailoring, cover letters & application tracking — available via the Model Context Protocol for Claude Code, Claude Desktop, Cursor, Windsurf, and other MCP clients.
Note: This is a hosted MCP server. Connect via the public endpoint below and sign in with Workopia (OAuth) — no API key to manage. All tools require a free Workopia sign-in; searching, job detail, resume tailoring, cover letters, and your dashboard are all scoped to your account. Resume tailoring and cover letters run on your own AI client's model — Workopia hosts no LLM and never charges for AI.
Endpoint
https://workopia.io/api/mcp-jobs
- Transport: Streamable HTTP
- Auth: OAuth 2.0 (Dynamic Client Registration + PKCE; handled automatically by the client)
- Website: https://workopia.io
Install as a Claude Code plugin
/plugin marketplace add workopia/workopia-mcp
/plugin install workopia-jobs
On first tool use, Claude Code opens the Workopia OAuth flow in your browser; the token is then stored and refreshed automatically.
Sign up and sign in
There is no separate GitHub-repository account and no API key to create. The first time an MCP client calls a Workopia tool, it opens the Workopia authorization page in your browser. Sign in with an email code, Google, LinkedIn, or GitHub.
- If that verified email already has a Workopia profile, the MCP connection uses it.
- Otherwise Workopia creates a minimal profile for that verified email.
- The MCP client stores and refreshes its OAuth token. Disconnect or remove Workopia in the client to revoke its local connection.
- Using the same verified email from another supported client connects activity to the same Workopia profile; it does not create a separate MCP-only account.
OAuth uses Authorization Code + PKCE and Dynamic Client Registration. Never paste a Workopia password, email code, OAuth token, or resume into this repository or a GitHub issue.
Tools
| Tool | What it does |
|---|---|
job_tool |
Search millions of live jobs across 90+ countries (employer career pages + ATS feeds — Lever, Greenhouse, Workday). Save a job to your account (sign-in). |
job_detail_tool |
Full detail for a single job — salary, requirements, skills, company. |
tailor_resume_tool |
Tailor your resume to a specific job description. |
cover_letter_tool |
Draft a cover letter for a specific role. |
dashboard_tool |
Open your Workopia dashboard — saved, tailored & applied jobs + latest resume (sign-in). |
Quick start (manual config)
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"workopia": {
"type": "streamable-http",
"url": "https://workopia.io/api/mcp-jobs"
}
}
}
Cursor — .cursor/mcp.json:
{
"mcpServers": {
"workopia": { "url": "https://workopia.io/api/mcp-jobs" }
}
}
ChatGPT — search "Workopia" in the ChatGPT App Store.
Also listed on
- MCP Registry:
io.github.Shuangshuang007/workopia - npm:
@shuang_workopia/workopia-mcp - OpenClaw ClawHub:
Shuangshuang007/workopia
Live on Glama
Quota
Free at launch. A free Workopia sign-in (OAuth) is required to use the tools — searching, job detail, resume tailoring, cover letters, and your dashboard. Need a higher quota or a custom arrangement? Email shuang@heraai.one.
Account activity and privacy
Authenticated tool actions such as job searches, job views, saved jobs, applications, resume operations, and cover-letter creation may be associated with your Workopia profile so your dashboard and history work across supported MCP clients. Workopia records the integration family (for example MCP) and, when the OAuth client identifies itself, the client type (for example Codex, Claude Code, Cursor, or Windsurf).
Conversation transcripts are not collected by this MCP server. Activity records do not contain OAuth tokens or raw resume text. Resume content needed for a requested resume operation is handled under the Workopia privacy policy linked below.
Report a bug / request a feature
Found something broken or want a tool improved? Open an issue — this repo is where we track bugs and feedback for the Workopia MCP server and Claude Code plugin. For account, billing, or anything private, email shuang@heraai.one.
About
Built by HERAAI PTY LLC. Privacy policy: https://workopia.io/privacy
Workopia MCP questions
How do I add Workopia MCP to Claude Code?
Run claude mcp add workopia-mcp -- npx -y @shuang_workopia/workopia-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Workopia MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Workopia MCP provide?
It exposes 5 tools, including job_tool, job_detail_tool, tailor_resume_tool, cover_letter_tool, dashboard_tool.
How do I authenticate with Workopia?
The server uses OAuth 2.0; on first use, the client will open a Workopia authorization page in your browser for you to sign in via email, Google, LinkedIn, or GitHub.
Do I need an API key to use this server?
No, you do not need to manage an API key. You simply sign in using Workopia OAuth.
Does Workopia provide the LLM for resume tailoring?
No, Workopia does not host an LLM; resume tailoring and cover letter drafting are performed by your own AI client's model.
What kind of jobs can I search for?
You can search millions of live jobs across more than 90 countries using employer career pages and ATS feeds like Lever, Greenhouse, and Workday.