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.
#Add the server
One command adds the GreenHired server to Claude Code. Then sign in from inside Claude Code.
claude mcp add --transport http greenhired https://mcp.greenhired.com/mcp - Run the command above.
- Start
claudeand type/mcp. - Choose
greenhiredand follow the browser sign-in. Choose the permissions on the GreenHired consent page. - 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.
claude mcp add --transport http greenhired-jobs https://mcp.greenhired.com/mcp \
--header "Authorization: Bearer $GREENHIRED_API_KEY" #Check it
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
401until you sign in. Choose the server in/mcpand 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_jobandlist_categories. With a key header: only those three. See Tools.
Was this page helpful?