Himalayas Remote Jobs MCP Server

by Himalayas-App

336 downloads
Not rated
GitHub

About

A Model Context Protocol (MCP) server that provides access to remote job listings and company information from Himalayas.app.

Details

Author
Himalayas-App
Downloads
336
Categories
Other

- Search jobs by keyword, country, or worldwide availability
- Browse latest remote job listings with pagination
- Search companies by keyword, country, or remote policy
- Browse remote-friendly companies with filtering
- Rich responses include salary, skills, employment type, and company details
- Supports OAuth authentication for secure access

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Himalayas Remote Jobs MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install by configuring your AI assistant (Claude Desktop, Cursor, or Windsurf) with the command npx mcp-remote https://mcp.himalayas.app/sse and completing OAuth authentication. Once connected, you can invoke tools like search_jobs, get_jobs, search_companies, and get_companies through natural language queries.

get_jobs

Browse the latest remote job listings with optional filtering by country or worldwide availability

search_jobs

Search for remote jobs using keywords with optional filtering by country or worldwide availability

get_job_details

Get full details for a specific job including description, requirements, salary, and application link. Use the company_slug and job_slug from job listings.

get_related_jobs

Find jobs similar to a specific job, based on skills, location, and category. Use after viewing a job to suggest alternatives.

get_companies

Browse remote-friendly companies with optional filtering by country or worldwide availability

search_companies

Search for remote-friendly companies using keywords with optional country filtering

get_company_details

Get full details for a company including about, tech stack, benefits, open positions, and social links

get_remote_work_statistics

Get remote work statistics: top skills, job categories, industries, or countries by job/company count. Great for understanding the remote work landscape.

get_salary_data

Get salary benchmarks for remote jobs by job title, with optional seniority and country filters. Returns min, max, and median salary in USD.

get_correct_country_name

Resolve a country name to the correct format accepted by Himalayas filters. Useful for fuzzy matching user input.

get_my_profile

Get your Himalayas profile information. Requires authentication.

save_job

Save a job to your application tracker. Requires authentication.

get_saved_jobs

Get all jobs in your application tracker. Requires authentication.

update_job_status

Update a saved job's status or details. Requires authentication.

remove_saved_job

Remove a job from your application tracker. Requires authentication.

update_profile

Update your Himalayas profile. Requires authentication.

add_experience

Add a work experience to your Himalayas profile. Requires authentication.

add_education

Add an education entry to your Himalayas profile. Requires authentication.

update_tech_stack

Update your tech stack on your Himalayas profile. Requires authentication.

search_talent

Search for remote talent/candidates on Himalayas. Browse professionals by keyword, country, or role.

get_talent_profile

Get full details for a candidate including bio, all experiences, education, tech stack, social links, and more. Use the talent_slug from search_talent results.

get_company_profile

Get your company's profile on Himalayas. Requires employer authentication.

update_company_profile

Update your company's profile on Himalayas. Requires employer authentication.

get_company_perks

Get your company's perks/benefits on Himalayas. Requires employer authentication.

add_company_perk

Add a perk/benefit to your company on Himalayas. Requires employer authentication.

remove_company_perk

Remove a perk/benefit from your company on Himalayas. Requires employer authentication.

update_company_tech_stack

Update your company's tech stack on Himalayas. Pass technology names (e.g., 'React', 'Python') and they'll be matched to the Himalayas stack database. Requires employer authentication.

list_company_jobs

List your company's job postings on Himalayas. Shows status, views, clicks, and expiry. Requires employer authentication.

show_company_job

Get full details of one of your company's job postings on Himalayas. Requires employer authentication.

create_company_job

Post a new job on Himalayas. Jobs are free to post and require admin approval before going live. Requires employer authentication.

update_company_job

Update an existing job posting on Himalayas. Only provide fields you want to change. For screening_questions, provide the full set — questions not included will be removed. Requires employer authentication.

delete_company_job

Delete a job posting from your company on Himalayas. This action cannot be undone. Requires employer authentication.

post_job_public

Post a job on Himalayas without an account. Provide your email and company details. Payment is required — a Stripe checkout URL will be returned. No authentication needed.

purchase_job_extras

Purchase paid extras for an existing job posting: sticky ($199), newsletter ($99). Returns a Stripe checkout URL. Requires employer authentication.

check_job_payment_status

Check the payment status of a job posting. Use the session_id returned from post_job_public or create_company_job with extras. No authentication required.

list_conversations

List all your messaging conversations with last message preview. Shows conversation status (awaiting reply, new reply, read). Requires employer authentication.

get_conversation

Get full message history for a conversation. Accepts room_name or talent_slug. Requires employer authentication.

start_conversation

Start a conversation with a candidate by talent slug. Optionally send an initial message. If the conversation already exists, returns it. Use search_talent to find candidates first, then use their slug here. Requires employer authentication.

send_message

Send a message in an existing conversation. Accepts room_name (from list_conversations) or talent_slug (from search_talent). Use start_conversation first if no conversation exists yet. Requires employer authentication.

mark_message_read

Mark a message as read by its ID. Requires employer authentication.

delete_conversation

Delete a conversation. Accepts room_name or talent_slug. Requires employer authentication.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "himalayas remote jobs mcp server": {
            "himalayas-mcp": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://mcp.himalayas.app/sse"
                ]
            }
        }
    }
}

McpServers

{
    "himalayas-mcp": {
        "command": "npx",
        "args": [
            "mcp-remote",
            "https://mcp.himalayas.app/sse"
        ]
    }
}

Himalayas Remote Jobs MCP Server

Access thousands of remote job listings and company information directly from your AI coding assistant! This public MCP server provides real-time access to Himalayas.app's remote job database.

🌐 Public Server URL: https://mcp.himalayas.app/sse

Install MCP Server

Available Tools

🔍 Job Search Tools

search_jobs

Search for specific jobs using keywords with advanced filtering.

Parameters:
- keyword (string, optional): Search term (e.g., 'Python', 'React', 'Product Manager', 'Data Scientist')
- page (number, optional): Page number for pagination (default: 1)
- country (string, optional): Filter jobs by country
- worldwide (boolean, optional): Show ONLY 100% remote jobs available worldwide

Example usage:
- "Search for Python developer jobs"
- "Find React jobs in the United States"
- "Look for product manager positions worldwide"

get_jobs

Retrieve the latest remote job listings with optional filtering.

Parameters:
- page (number, optional): Page number for pagination (default: 1)
- country (string, optional): Filter jobs by country (e.g., 'Canada', 'United States', 'UK', 'Germany')
- worldwide (boolean, optional): Show ONLY 100% remote jobs available worldwide (default: false)

Example usage:
- "Get remote jobs in Canada"
- "Show me worldwide remote opportunities"
- "Find jobs on page 2"

🏢 Company Search Tools

search_companies

Search for specific companies using keywords.

Parameters:
- keyword (string, optional): Search term (e.g., 'startup', 'fintech', 'AI', company name)
- page (number, optional): Page number for pagination (default: 1)
- country (string, optional): Filter companies by country
- worldwide (boolean, optional): Show only companies with 100% remote jobs available worldwide

Example usage:
- "Search for AI startups"
- "Find fintech companies with remote jobs"
- "Look for companies named 'Stripe'"

get_companies

Browse remote-friendly companies with optional filtering.

Parameters:
- page (number, optional): Page number for pagination (default: 1)
- country (string, optional): Filter companies by country
- worldwide (boolean, optional): Show only companies with 100% remote jobs available worldwide

Example usage:
- "Show me remote companies in Europe"
- "Find companies with worldwide remote jobs"

Setup Instructions

🖥️ Claude Desktop

1. Open Claude Desktop and navigate to Settings → Developer → Edit Config
2. Replace the content with this configuration:

{
  "mcpServers": {
    "himalayas": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.himalayas.app/sse"]
    }
  }
}

3. Save the file and restart Claude Desktop (Cmd/Ctrl + R)
4. When Claude restarts, a browser window will open for OAuth login - complete the authorization
5. You'll see the Himalayas tools available by clicking the tools icon (🔨) in the bottom right

⚡ Cursor

1. Open Cursor and go to Settings → Features → Rules for AI
2. Choose Type: "Command"
3. In the Command field, enter:

npx mcp-remote https://mcp.himalayas.app/sse

4. Save the configuration and restart Cursor
5. Complete the OAuth flow when prompted

🌊 Windsurf

1. Edit your mcp_config.json file
2. Add this configuration:

{
  "mcpServers": {
    "himalayas": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.himalayas.app/sse"]
    }
  }
}

3. Save the file and restart Windsurf
4. Complete the OAuth authorization when prompted

Example Conversations

Once connected, you can have natural conversations with your AI assistant:

Job Searching

- "I'm looking for remote Python developer jobs in Europe" - "Show me the latest remote data science positions" - "Find part-time remote marketing jobs worldwide" - "Search for senior software engineer roles in Canada"

Company Research

- "Find AI startups that offer remote work" - "Show me fintech companies with remote opportunities" - "Look for companies in Germany that hire remotely" - "Find verified companies with 4-day work weeks"

Advanced Queries

- "Compare remote job opportunities between the US and UK" - "Find companies that offer both remote work and competitive salaries" - "Show me the tech stack used by remote-first companies"

What You'll Get

Each response includes rich, formatted information:

Job Listings

- 🚀 Job title and company name - 💼 Employment type (Full-time, Part-time, Contract) - 🌍 Location restrictions or worldwide availability - 💰 Salary ranges and currency - 🛠️ Required skills and technologies - 🔗 Direct application links - 🏢 Company verification status

Company Profiles

- 🏢 Company name and verification status - 👥 Company size and founding year - 🌍 Locations and remote work policies - 🔥 Number of open positions - 🎁 Benefits and perks information - ⚡ Technology stacks used - 🌐 Company website and social links

Troubleshooting

Connection Issues

- Ensure you have Node.js installed for the npx command - Try restarting your AI assistant after configuration changes - Clear authentication cache if needed: rm -rf ~/.mcp-auth

Authentication Problems

- Complete the OAuth flow in the browser window that opens - Make sure you're using the correct server URL: https://mcp.himalayas.app/sse - Check that your internet connection is stable

Tool Not Appearing

- Verify the configuration file syntax is correct (valid JSON) - Restart your AI assistant completely - Check the tools icon/menu in your AI assistant's interface

Support

If you encounter any issues:
1. Check the troubleshooting section above
2. Verify your configuration matches the examples exactly
3. Try the connection with the MCP Inspector first

---

Powered by Himalayas.app - The best place to find remote jobs and companies 🏔️

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.