Linxa MCP Server

Expose your Linxa inbox to AI agents like Claude and OpenClaw using the Model Context Protocol.

Quickstart

1

Install Extension

Get the Linxa Chrome Extension and pin it.

2

Sign in to Linxa

Log in via the extension or dashboard.

3

Generate Token

Go to Settings > MCP to get your key.

4

Configure & Run

Add LINXA_API_TOKEN and run a test command.

Core Capabilities

List Conversations

Access your inbox filtered by labels like 'hot' or 'need-reply'.

Search Inbox

Find specific conversations instantly using semantic search.

High Priority

Get immediate access to high-priority leads and hot conversations.

Conversation Details

Retrieve full message history and context for any conversation.

Setup Guide

1

Generate API Token

1. Go to your Linxa Dashboard.

2. Navigate to Setup MCP.

3. Generate and copy your API Token.

2

Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "linxa": {
      "command": "node",
      "args": [
        "/path/to/linxa-mcp-server/index.js"
      ],
      "env": {
        "LINXA_API_TOKEN": "YOUR_API_TOKEN_HERE",
        "LINXA_API_URL": "https://app.uselinxa.com/api" 
      }
    }
  }
}
3

Run with OpenClaw

Set environment variables:

  • LINXA_API_TOKEN
  • LINXA_API_URL

Real Usage Examples

Copy and paste these prompts to test your agent immediately.

Verify Connection

Verify current user and show my profile details

List Conversations

List my inbox conversations and show the last message for each

Fetch Messages

Fetch messages for conversation [insert_id_here]

Search

Search conversations for "pricing" or "demo"

Available Tools

These tools are automatically exposed to your AI agent.

linxa_list_conversations

List recent conversations.

linxa_get_conversation

Get details for a conversation.

linxa_get_hot_conversations

Get high priority leads.

linxa_search_conversations

Search your inbox.

Security by Design

Your data stays yours. We prioritize strict security protocols.

No Password Sharing

We never ask for or store your LinkedIn password. Access is handled via a secure, user-controlled session token.

Token-Based Access

Your API token is the only key. You can revoke it instantly from your dashboard if needed.

Session Reliability

The MCP endpoint stays reachable, but real-time message sync requires an active browser session or extension.

Minimal Data Storage

We cache minimal metadata to speed up your agent's queries. Message content is fetched on demand.

Troubleshooting

Token Invalid or Expired

Tokens may expire if you log out. Regenerate a new token in the Linxa Dashboard.

Extension Not Installed

The MCP server relies on your browser extension to proxy requests to LinkedIn securely.

Not Signed Into LinkedIn

Ensure you are logged into LinkedIn in the browser where the extension is installed.

Sync Not Updating

Keep the Linxa tab or extension active to ensure continuous background sync for real-time updates.

Rate Limits

If you hit a rate limit, the tool will pause. Wait a few minutes before retrying to protect your account.

Why Linxa MCP?

Solve common AI development headaches instantly.

  • The VM Setup HeadacheSkip the VM stress—spin up your chat assistant on your own machine in under 5 minutes. Free, secure, zero infra headaches.
  • Endless Credentials HellOne environment variable, one CLI install. Everything else “just works.” No more secret-vault gymnastics.
  • The Feature Creep TrapFocus on what matters. Start with chat-driven prospecting—LinkedIn messages, lead capture—in a consolidated “Lite” package.
  • Over-Engineering AI PipelinesPre-built agent templates mean you skip the pipeline and jump straight to conversation. Plug-and-play sampling of your own data in seconds.
  • The Hidden Costs of ScaleRun locally or in burst-mode on free tier cloud. No surprise invoices.
  • Team Onboarding OverheadOne CLI install, one config file—everyone on the same page instantly.
  • Siloed Tools & Switch FatigueUnified chat interface connects to all your tools via one plugin. Type once, get context everywhere.
  • Analytics ParalysisInstant natural-language reports (“Show me last week’s leads”) right in your chat. Zero waiting.
  • Security Audit NightmaresBuilt-in audit trail and least-privilege defaults—your security team can sleep through the night.
  • The “But It’s Free” ParadoxEarly-bird program is truly free—no usage caps, no surprise charges, only a brighter chat experience.