MCP server · Start here

Connect an assistant in two minutes

Add the GreenHired MCP address to your AI assistant, sign in with GreenHired, choose what it may do, and try your first prompt. Remove it any time.

2 min read Updated Maintained by the GreenHired team
View Markdown
On this page
  1. The short version
  2. What the consent page shows
  3. Try it
  4. Remove it
  5. Check the server from a terminal
  6. Frequently asked questions

#The short version

  1. Add https://mcp.greenhired.com/mcp to your assistant as a remote MCP server (in Claude and ChatGPT this is a "custom connector").
  2. Your assistant opens a GreenHired page. Sign in as a job seeker or an employer.
  3. Read what the app asks for, tick the permissions you are happy with, and allow it. Write permissions are not ticked for you.
  4. Go back to the assistant and ask for something.
The address to add
Text
https://mcp.greenhired.com/mcp

The steps in each assistant differ: use the guide for yours, in Connect Claude, Claude Code, ChatGPT, Cursor or Other clients.

#Try it

  • Job seeker: "Show me my saved jobs" or "Find hybrid jobs in clean transportation posted this week."
  • Employer: "List my company's active jobs and how many applications each has."
  • Anyone: "Which green job categories have the most open jobs?"

The assistant shows the tools it is using. Each job it finds includes a link to the job on greenhired.com.

#Remove it

Job seekers: open Profile and settings, then Account, then Connected apps. Employers: open Company, then Connected app. Press Remove next to the assistant. It stops working immediately.

#Check the server from a terminal

With a ghk_ key you can talk to the server directly. This lists its tools:

curl
curl -s https://mcp.greenhired.com/mcp \
  -H "Authorization: Bearer $GREENHIRED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

More in Protocol notes.

#Frequently asked questions

Why does it say the app is not verified?
Assistants register themselves with GreenHired, and we do not vet them. The page says so on purpose, so you decide knowing it. Connect only assistants you started yourself.
Which account do I sign in with?
The GreenHired account you want the assistant to act for: a job seeker account for your own profile and jobs, an employer account for your company.
Can the assistant change things without asking me?
Only what you allowed. Read-only permissions cannot change anything. If you tick a write permission, a good assistant still confirms before it saves or updates, but the permission is yours to give or withhold.