MCP Server for LinkedIn for Windsurf: Setup & Config

What you can do with MCP Server for LinkedIn in Windsurf

Choose local LinkedIn research with section-aware profiles and reusable browser authentication.

• Find job listings by keyword and location.
• Read inbox threads before drafting a response.

Before you start: MCP Server for LinkedIn in Windsurf

• uv
• A LinkedIn account and authenticated browser session
• An MCP-compatible client

The README launches the local server with uvx. Browser preparation happens automatically; first use may require sign-in. Streamable HTTP is also documented.

MCP Server for LinkedIn Windsurf configuration

1. Choose Windsurf configuration scope

   For MCP Server for LinkedIn, open macOS/Linux: ~/.codeium/windsurf/mcp_config.json Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json. Merge into mcpServers; remote endpoints use serverUrl.

2. Add MCP Server for LinkedIn to Windsurf

   Use the linkedin-mcp-server entry below in mcpServers. Keep MCP Server for LinkedIn's documented stdio connection fields and your other Windsurf entries.

3. Check MCP Server for LinkedIn in Windsurf

   MCP Server for LinkedIn: Refresh MCP in Windsurf settings and inspect Cascade’s tools.

{
  "mcpServers": {
    "linkedin-mcp-server": {
      "command": "uvx",
      "args": [
        "mcp-server-linkedin@latest"
      ],
      "env": {
        "UV_HTTP_TIMEOUT": "<uv package download timeout in seconds>"
      }
    }
  }
}

MCP Server for LinkedIn tools available to Windsurf

MCP Server for LinkedIn's stored tool list documents 17 tools; compare it with Windsurf's connected tool list, because the stored list is not a live check.

get_person_profile

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for get_person_profile.

Read selected sections of a LinkedIn member profile.

get_my_profile

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for get_my_profile.

Read chosen sections of the signed-in account's profile.

connect_with_person

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for connect_with_person.

get_sidebar_profiles

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for get_sidebar_profiles.

get_inbox

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for get_inbox.

get_conversation

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for get_conversation.

search_conversations

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for search_conversations.

Find conversations containing a keyword.

send_message

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for send_message.

Send a message after confirmation; the README links known issues.

get_company_profile

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for get_company_profile.

Read company information and selected company sections.

get_company_posts

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for get_company_posts.

search_companies

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for search_companies.

get_company_employees

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for get_company_employees.

search_jobs

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for search_jobs.

search_people

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for search_people.

Find members by keywords, location, connection distance, or current employer.

get_job_details

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for get_job_details.

Inspect the information in a particular job listing.

get_feed

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for get_feed.

Read recent posts in the authenticated home feed.

close_session

After refreshing MCP Server for LinkedIn in Windsurf settings, check Cascade's tool list for close_session.

Shut down the browser session and release its resources.

MCP Server for LinkedIn: full stored tool descriptions

Troubleshooting MCP Server for LinkedIn in Windsurf

• Check uvx mcp-server-linkedin@latest (from uv, for Python tools) on the machine running Windsurf's MCP integration for MCP Server for LinkedIn; refresh MCP and inspect Cascade's tools.
• Check UV_HTTP_TIMEOUT for MCP Server for LinkedIn; do not bypass a Windsurf permission error with a broad administrator token.
• MCP Server for LinkedIn uses stdio here: Windsurf must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Requires a working LinkedIn session and may need manual login or CAPTCHA handling.
• Known limitation: Requests within one server process run sequentially.
• Known limitation: Connection and message actions have issue references in the README.
• General Windsurf troubleshooting lives in the /clients/windsurf guide.

Frequently asked questions