handshake-mcp
This MCP server gives AI assistants access to the Handshake student job platform through an authenticated browser session, enabling the following:
Search jobs — Find postings by keywords, location, or job type (full-time, part-time, internship, co-op, fellowship, volunteer)
View job details — Retrieve full descriptions, requirements, salary, application deadlines, and application method
Apply to jobs — Submit applications with optional resume/cover letter attachments (excludes external-apply jobs)
Track applications — View submitted applications and their statuses (pending, accepted, declined, withdrawn, interview), with optional filtering; withdraw applications as needed
Manage saved jobs — Bookmark jobs, remove bookmarks, and list all saved postings
Research employers — Search companies by name or industry, and view profiles including description, industry, employee count, and open positions
Access your profile — View your Handshake student profile (name, school, major, graduation year, account status)
Manage documents — List uploaded resumes, cover letters, and other files, and retrieve their IDs for use when applying
Provides tools to search jobs, apply, track applications, and research employers on Handshake.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@handshake-mcpsearch for software engineering internships in San Francisco"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
handshake-mcp
An MCP server that gives AI assistants like Claude access to Handshake — search jobs, apply, track applications, and research employers through your own browser session.
Disclaimer: This project is independent and unaffiliated with Handshake. Automated access may violate Handshake's Terms of Service. Use for personal productivity only.
Tools
Tool | Description |
| Search by keyword, location, or job type |
| Full description, requirements, salary, deadline |
| Submit an application, attach resume/cover letter |
| Save / unsave jobs (follow) |
| Application tracking |
| Company research (keyword search) |
| Your Handshake student profile |
| Manage resumes and cover letters |
Related MCP server: LinkedIn MCP Server
Quick start
With uvx (recommended)
# First-time login
uvx handshake-mcp --login
# Add to Claude Code (~/.claude/.mcp.json){
"mcpServers": {
"handshake": {
"command": "uvx",
"args": ["handshake-mcp"]
}
}
}From source
git clone https://github.com/shahparam11/handshake-mcp-server.git
cd handshake-mcp
uv sync
# First-time login
uv run handshake-mcp --loginAdd to ~/.claude/.mcp.json:
{
"mcpServers": {
"handshake": {
"command": "uv",
"args": ["run", "--project", "/path/to/handshake-mcp", "handshake-mcp"]
}
}
}Restart Claude Code. The hs_* tools are now available.
With Docker
docker build -t handshake-mcp .
# Login (mounts session storage)
docker run -it -v ~/.handshake-mcp:/root/.handshake-mcp handshake-mcp --login
# Run as MCP server
docker run -i -v ~/.handshake-mcp:/root/.handshake-mcp handshake-mcpCLI
handshake-mcp --login # authenticate via browser
handshake-mcp --status # check session validity
handshake-mcp --logout # clear saved session
handshake-mcp --version # print versionHow it works
On --login, a Patchright Chromium browser opens. After you log in, the full browser profile (cookies, localStorage, IndexedDB) is saved to ~/.handshake-mcp/. Subsequent tool calls use these cookies via an httpx client against Handshake's internal REST API at app.joinhandshake.com/stu/.
CSRF protection uses the double-submit cookie pattern — the CSRF-TOKEN cookie value is reflected back as the X-CSRF-Token request header.
Note: Handshake's internal API is undocumented. If a tool returns 404, open browser DevTools on Handshake → Network tab, find the matching request path, and update the relevant
handshake_mcp/tools/*.pyfile.
Session refresh
handshake-mcp --loginProject layout
handshake_mcp/
├── cli_main.py # Entry point — --login/--logout/--status/server
├── server.py # FastMCP server factory
├── auth.py # Patchright login + profile/cookie storage
├── client.py # Authenticated httpx client
├── exceptions.py # CredentialsNotFoundError, SessionExpiredError
└── tools/
├── jobs.py # hs_search_jobs, hs_get_job, hs_apply, hs_save/unsave_job
├── employers.py # hs_search_employers, hs_get_employer
├── applications.py # hs_get_applications, hs_withdraw_application
└── profile.py # hs_get_profile, hs_upload/get/delete_documentDevelopment
uv sync --group dev
uv run pytest --cov
uv run ruff check .License
MIT — see LICENSE.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/shahparam11/handshake-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server