Connect your AI assistant to GreenHired with MCP
The GreenHired MCP server connects an AI assistant such as Claude to GreenHired. MCP, the Model Context Protocol, is the standard way an assistant calls outside tools. The assistant can search green jobs and, if you allow it, read or change parts of your own account. You add one address, sign in and tick what it may do, and there is no GreenHired app to install.
- No GreenHired app to install
- You choose each permission
- Remove it at any time
Six things your assistant can do with GreenHired
Each one is a tool, a named action the assistant can call, such as search_jobs.
Search live jobs
Filter by category, country, work mode, employment type, seniority, pay with its currency, and how recently a job was posted. The filters match the public jobs API.
search_jobsRead one job in full
Get the whole description as plain text, with a link back to the job on greenhired.com.
get_jobBrowse 28 green categories
See every category with the number of live jobs in it, then search inside the one you want.
list_categoriesRead and update your profile
Job seekers can let an assistant read their headline, skills and job search status, and change them if they allow it. Email, phone and CV are never included.
get_my_profile, update_my_profileTrack applications and saved jobs
List your applications and where each stands, and save or unsave open jobs. An assistant cannot apply for you.
list_my_applications, save_jobSee your company's jobs
Employers can ask for the company profile and a list of the company's jobs with status, dates and number of applications. Applicants are not included.
get_my_company, list_company_jobsYou decide what the assistant can do
When you connect, GreenHired shows a consent page. You tick permissions one by one, and the assistant gets exactly those.
- Reading permissions are ticked for you. Writing permissions never are.
- The page says the app is not verified by GreenHired, because apps register themselves. Only continue if you started the connection yourself.
- Remove any assistant on your Connected apps page and it stops at once.
- Changing your password or turning off two-factor sign-in removes every connected assistant, and so does a sign-out by GreenHired support.
Connect in four steps
The screens differ a little in each assistant. The guides further down cover the main ones.
- 01
Add the address
Add https://mcp.greenhired.com/mcp to your assistant as a remote MCP server. In Claude this is a custom connector, and in ChatGPT a custom MCP server.
- 02
Sign in with GreenHired
Your assistant opens a GreenHired page. Sign in as a job seeker or an employer.
- 03
Tick what it may do
Read what the app asks for, tick the permissions you are happy with and allow it.
- 04
Ask for something
Go back to the assistant and ask in plain words. Each job it finds links to greenhired.com.
Mia searches, saves and checks
Mia is a solar project engineer who lives in Leeds and wants a remote job with a German employer. She connected Claude to her job seeker account, left the pre-ticked read permissions on and ticked saving jobs. Mia and her prompts are invented. The tool names and limits come from the live server.
Mia, job seeker- Find remote renewable energy jobs in Germany paying over 60,000 euros.
The assistant calls search_jobs with a category, a work mode, a country, a minimum pay and the currency, then lists the matching jobs with links.
- Save the second one.
It calls save_job. This works because Mia ticked saving jobs. Without that permission, the tool is not offered at all.
- Which of my applications are still in review?
It calls list_my_applications and shows each job with its status. It cannot see her CV, cover letter or recruiter notes.
Claude shows which GreenHired tools it calls, so Mia can see what ran.
The permissions you can tick
Job seekers see five, employers see three. Reading permissions are ticked for you, and writing permissions never are.
| Permission | What the assistant can do |
|---|---|
profile:read | See your profile: headline, summary, location, skills, desired roles, job search status and work mode |
profile:write | Edit parts of your profile |
applications:read | See the jobs you applied to and where each one stands |
saved:read | See your saved jobs |
saved:write | Save and unsave jobs for you |
company:read | Employers: see your company profile and your role in it |
jobs:read | Employers: see your company's jobs, with the number of applications each has |
The jobs:write permission is for personal keys only, so an assistant cannot create or change jobs.
What an assistant cannot do
These actions have no tool, permission or endpoint, so no assistant can do them, whatever you tick.
No assistant can
- Apply to a job or message anyone
- Read an email address, phone number, CV or cover letter
- See an applicant, a recruiter note or a score
- Create, change, publish or close a job
- Change an email, password, two-factor, privacy or notification setting
Guides for each assistant
Any assistant that supports remote MCP servers with sign-in should be able to connect. We tested Claude on the live server on 21 November 2026. The other guides follow each vendor's own documentation, read on the same date.
Claude
Add GreenHired as a custom connector on the web or desktop.
Claude Code
Add the server with one command from your terminal.
ChatGPT
Add GreenHired as a custom MCP server and sign in.
Cursor
Add a few lines to mcp.json and use jobs in your editor.
Other clients
VS Code, MCP Inspector and anything that speaks remote MCP.
Building your own agent?
Developers can point their own agent at the same server. Job search can use a public jobs API key, which the GreenHired team issues on request, and your own account data is available through the account API with a personal key.
Tool reference
Every tool with its permission, plus the arguments and a sample call for job search.
Security for agent builders
What assistants cannot do and how to treat tool output safely.
API for job seekers
Read your own profile, applications and saved jobs from your scripts.
API for recruiters
Manage your company jobs from your own systems.
Questions people ask
What is MCP?
MCP stands for Model Context Protocol. It is an open standard that lets an AI assistant use outside tools and data. GreenHired runs one MCP server, so an assistant that speaks MCP can search our jobs and, with your permission, use your account.
Who can use it, and do I need a developer account?
Job seekers and employers can both use it, and neither needs a developer account. You need a GreenHired account and an assistant that supports remote MCP servers. Company owners decide which roles in a company may connect an assistant.
Can an assistant apply for jobs for me?
No. There is no tool to apply, message anyone or change a job. The search tools only read, and a job seeker can also allow profile edits and saved jobs.
What does the assistant see about me, and where does it go?
Only the fields each permission lists, such as your headline and skills. Never your email address, phone number, CV, cover letter, recruiter notes or scores. What an assistant reads goes to the company that runs it, under its own terms, so tick only what you are happy to share.
Which assistants work with it?
Any assistant that supports remote MCP servers with sign-in should be able to connect. We tested Claude on the live server. The guides for ChatGPT, Cursor, Claude Code and VS Code follow each vendor's own documentation.
How do I disconnect an assistant?
Job seekers open Profile and settings, then Account, then Connected apps. Employers open Company, then Connected app. Press Remove and the assistant stops working at once.
Try it with your own assistant
Add one address, sign in and ask for a job search. You can remove the connection at any time.