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-mcp search 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.
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.
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
# First-time login
uvx handshake-mcp --login
# Add to Claude Code (~/.claude/.mcp.json){
"mcpServers": {
"handshake": {
"command": "uvx",
"args": ["handshake-mcp"]
}
}
}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.
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-mcphandshake-mcp --login # authenticate via browser
handshake-mcp --status # check session validity
handshake-mcp --logout # clear saved session
handshake-mcp --version # print versionOn --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.
handshake-mcp --loginhandshake_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_documentuv sync --group dev
uv run pytest --cov
uv run ruff check .MIT — see LICENSE.
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Give AI agents the LinkedIn tools to find, qualify, engage, and follow up with prospects.
Search AI-native jobs, inspect application forms, and fetch free interview-prep resources.
AI-powered browser automation — navigate, click, fill forms, and extract data from any website.
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