@striderlabs/mcp-nextdoor

MCP (Model Context Protocol) server for Nextdoor — the local community platform. Automate neighborhood feed browsing, marketplace search, event discovery, and local service finding using Playwright with Browserbase.

Requirements

• Node.js 18+

• A Browserbase account with a CDP-enabled session URL

• A Nextdoor account

Environment Variables

Installation

npm install @striderlabs/mcp-nextdoor

Or from tarball:

npm install ./striderlabs-mcp-nextdoor-1.0.0.tgz

MCP Configuration

Add to your MCP client config (e.g., Claude Desktop ~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "nextdoor": {
      "command": "node",
      "args": ["/path/to/node_modules/@striderlabs/mcp-nextdoor/dist/index.js"],
      "env": {
        "BROWSERBASE_CDP_URL": "wss://connect.browserbase.com?apiKey=YOUR_KEY&sessionId=YOUR_SESSION",
        "NEXTDOOR_EMAIL": "you@example.com",
        "NEXTDOOR_PASSWORD": "yourpassword"
      }
    }
  }
}

Tools

get_feed

Get posts from your Nextdoor neighborhood feed.

Parameters:

• limit (number, 1-50, default: 10) — Number of posts to retrieve

• category (string, default: "all") — Filter by: all, crime_safety, lost_found, free_stuff, recommendations, general

Example:

{ "limit": 5, "category": "crime_safety" }

create_post

Draft a new post in your Nextdoor neighborhood. The post is loaded into the composer but not auto-submitted (safety measure).

Parameters:

• title (string, required) — Post title

• body (string, required) — Post body content

• category (string, default: "general") — Category: general, crime_safety, lost_found, free_stuff, recommendations

Example:

{ "title": "Lost black cat - Maple St area", "body": "Missing since Tuesday evening...", "category": "lost_found" }

search_marketplace

Search Nextdoor's For Sale & Free marketplace.

Parameters:

• query (string, required) — Search terms

• max_price (number, optional) — Maximum price

• min_price (number, optional) — Minimum price

• limit (number, 1-50, default: 10) — Number of listings

Example:

{ "query": "bicycle", "max_price": 200, "limit": 5 }

get_events

Get upcoming local events from Nextdoor.

Parameters:

• limit (number, 1-50, default: 10) — Number of events

• days_ahead (number, 1-90, default: 30) — Days ahead to look

Example:

{ "limit": 10, "days_ahead": 14 }

get_recommendations

Get local business recommendations from neighbors.

Parameters:

• category (string, default: "all") — Business type (e.g., restaurant, plumber, dentist)

• limit (number, 1-50, default: 10) — Number of recommendations

Example:

{ "category": "restaurant", "limit": 5 }

find_services

Search for local service providers.

Parameters:

• service_type (string, required) — Service to find (e.g., plumber, electrician, babysitter)

• limit (number, 1-50, default: 10) — Number of providers

Example:

{ "service_type": "house cleaner", "limit": 5 }

How It Works

The server uses Playwright to connect to a Browserbase-managed Chromium browser via CDP (Chrome DevTools Protocol). It navigates to Nextdoor, authenticates with your credentials, and scrapes or interacts with the page to fulfill tool requests.

MCP Client → mcp-nextdoor server → Playwright CDP → Browserbase → Chromium → nextdoor.com

Notes

• Authentication: The server logs in using email/password on first use. Sessions are reused across tool calls.

• Post creation: create_post drafts content into the composer but does not submit automatically to prevent accidental posts.

• Selectors: Nextdoor's frontend changes periodically. If extraction returns empty results, the page structure may have changed.

• Rate limiting: Be respectful of Nextdoor's terms of service and avoid excessive automated requests.

License

MIT — Strider Labs