MCP server · Connect a client

Connect Claude Code to GreenHired

Add the GreenHired MCP server to Claude Code with one command, sign in with /mcp, or use a read-only API key header. Includes scopes and the one pitfall.

1 min read Updated Maintained by the GreenHired team
View Markdown
On this page
  1. Add the server
  2. Use an API key instead
  3. Check it
  4. Frequently asked questions

#Add the server

One command adds the GreenHired server to Claude Code. Then sign in from inside Claude Code.

curl
claude mcp add --transport http greenhired https://mcp.greenhired.com/mcp
  1. Run the command above.
  2. Start claude and type /mcp.
  3. Choose greenhired and follow the browser sign-in. Choose the permissions on the GreenHired consent page.
  4. Ask for something: "Use GreenHired to list remote renewable energy jobs."

By default the server is stored for you in the current project. Add --scope user to use it in every project, or --scope project to write it to a shared .mcp.json.

#Use an API key instead

For the three job search tools only, you can send a ghk_ key as a header. Give this server a different name from the sign-in one.

curl
claude mcp add --transport http greenhired-jobs https://mcp.greenhired.com/mcp \
  --header "Authorization: Bearer $GREENHIRED_API_KEY"

#Check it

curl
claude mcp list

These details are from the Claude Code documentation at code.claude.com/docs/en/mcp, read on 21 November 2026. Commands and flags can change, so check it if something differs.

#Frequently asked questions

Why does /mcp say the server needs authentication?
That is expected the first time: GreenHired answers 401 until you sign in. Choose the server in /mcp and complete the browser sign-in.
Can I put the key in .mcp.json?
You can reference an environment variable rather than writing the key into a file you commit. Never commit a key.
Which tools will I get?
After signing in: your account tools for the permissions you ticked, plus search_jobs, get_job and list_categories. With a key header: only those three. See Tools.