passport-mcp

PassportMCP (ppmcp) lets you build MCP servers for any given website with automatic browser auth syncing. Every website is fair game. It wraps FastMCP and automatically adds necessary auth headers and cookies from the browser to outbound requests. As long as you log in through the browser, it's ready to be used. Often easier than paying for developer APIs (ex: twitter/X), avoiding rate limits, waiting for approval, or great for sites that don't have one.

Not building an MCP server? You can use the ultra-lightweight BrowserPassport http client instead! Scroll down

• 🔐 Automatic browser auth syncing
• 🛠️ Normal MCP tool creation
• 🌐 Works with any website
• 🔄 Always uses latest auth state
• 🍪 Handles cookies and headers
• 🔒 All credentials stay on your machine

1. Install the Package

pip install ppmcp

2. Set Up Native Messaging and Auth Syncing

ppmcp setup  # Sets up with Chrome Web Store extension

3. Enable Request Monitoring

   • Click the PassportMCP extension icon in Chrome
   • Toggle "Monitor Requests" on
   • Visit and log into your target website

4. Create Your First MCP Tool

from passportmcp import PassportMCP

# Create an MCP instance
mcp = PassportMCP("example", "example.com")

# Define a tool
@mcp.tool()
async def get_data():
    response = mcp.client.get("https://example.com/api/data")
    return response.json()

pip install ppmcp
ppmcp setup

1. Build the Extension

git clone https://github.com/joshmayerr/passport-mcp.git
cd extension
npm install
npm run build  # or npm run dev for watch mode

2. Load in Chrome

   • Open Chrome and go to chrome://extensions
   • Enable "Developer mode" in the top right
   • Click "Load unpacked" and select the extension/dist directory
   • Note the extension ID from Chrome (shown under the extension name)

3. Set Up Native Messaging

ppmcp setup --local --extension-id=your_extension_id
# OR
ppmcp setup --local  # You'll be prompted for the ID

• ppmcp setup - Set up native messaging
• ppmcp doctor - Check installation status
• ppmcp uninstall - Remove PassportMCP

PassportMCP consists of three main components:

1. Chrome Extension

   • Monitors web requests
   • Captures authentication state
   • Sends to native host

2. Native Host

   • Receives data from extension
   • Stores authentication state
   • Provides data to SDK

3. SDK

   • PassportMCP: High-level MCP tool creation
   • BrowserPassport: Low-level auth handling

from passportmcp import PassportMCP

mcp = PassportMCP("linkedin", "linkedin.com")

@mcp.tool()
async def search_linkedin(query: str):
    response = mcp.client.get(
        "https://www.linkedin.com/voyager/api/graphql",
        params={
            "includeWebMetadata": "true",
            "variables": "()",
            "queryId": "voyagerDashMySettings.7ea6de345b41dfb57b660a9a4bebe1b8"
        }
    )
    return response.json()

For simpler use cases where you don't need MCP tools, use the lightweight BrowserPassport HTTP client directly:

from passportmcp import BrowserPassport

# Initialize the client
client = BrowserPassport()

# Make authenticated requests
response = client.get("https://api.example.com/data")
data = response.json()

• 🔄 Automatic credential injection from browser
• 🌳 Path-based credential inheritance
• 🛠️ Full HTTP method support (GET, POST, PUT, DELETE)
• 🔒 Local credential storage
• 🚀 Built on httpx for modern HTTP features

# Custom configuration
client = BrowserPassport(
    storage_path="~/custom/path/creds.json",
    timeout=60.0,
    verify=True  # SSL verification
)

# Custom headers/cookies (override stored ones)
response = client.post(
    "https://api.example.com/data",
    headers={"Custom-Header": "value"},
    cookies={"custom_cookie": "value"},
    json={"key": "value"}
)

• ✅ Credentials never leave your machine
• ✅ No cloud storage or transmission
• ✅ Limited to authorized domains
• ✅ LLMs never see your credentials

Unlike services like Anon and Rabbit that automate accounts in the cloud, PassportMCP keeps everything local and secure.

For SDK development:

cd sdks/python
pip install -e .

passport-mcp/
├── extension/            # Chrome extension
├── sdks/
│   ├── python/          # Python SDK
│   └── typescript/      # TypeScript SDK (coming soon)
└── shared/
    └── native-host/     # Native messaging host

• TypeScript SDK
• Firefox extension
• Safari extension
• Auth state sharing
• Enterprise features
• More language SDKs

MIT License - see LICENSE for details