Common Room MCP Server

Official Common Room MCP server. Query and write GTM intelligence: product signals, community activity, intent data, contact and account enrichment.

Data & Enrichment by Common Room OAuth2 active

Connect (Remote Server) Docs

Overview

The Common Room MCP server connects AI assistants directly to your Common Room workspace, exposing go-to-market intelligence (product signals, community activity, intent data, identity resolution, and contact/account enrichment) through the Model Context Protocol. It is provider-hosted at https://mcp.commonroom.io/mcp and uses OAuth 2.1 for authentication, so tokens are user-scoped and respect existing workspace role-based access controls.

The server supports both reads and writes. Beyond querying contacts, organizations, activities, and segments, agents can create new records and update existing ones from natural language. Typical workflows include account research briefs, contact profile lookups, call prep, signal-based prospecting, personalized outreach drafting, and pushing structured notes or activities back into Common Room.

Common Room exposes a small, generic tool surface (catalog discovery plus list/create/update on objects) that the AI client uses to navigate any object type in the workspace. The connector is available across Claude (directory connector and Claude plugin), ChatGPT, Cursor, GitHub Copilot, and any other HTTP-compatible MCP client.

Tools

Tool	Description
`commonroom_get_catalog`	Discover available object types and properties in the connected Common Room workspace.
`commonroom_list_objects`	Query contacts, organizations, activities, or segments using filters and signals.
`commonroom_create_object`	Create new records with upsert semantics for contacts and organizations.
`commonroom_update_object`	Modify existing records by ID.

Setup Guide

Common Room hosts the MCP server, so there is nothing to install or run locally. You point your MCP client at the hosted endpoint and complete the OAuth flow in a browser.

Endpoint: https://mcp.commonroom.io/mcp Transport: Streamable HTTP Auth: OAuth 2.1 (user-scoped, honors workspace RBAC)

Prerequisites

Active Common Room instance and a user account with access to the workspace
MCP-compatible AI client (Claude, ChatGPT, Cursor, GitHub Copilot, Windsurf, Zed, Amazon Q, etc.)

Claude

Install the Common Room connector from Claude's directory and complete the OAuth authorization in the browser.

ChatGPT

Add Common Room from the ChatGPT App Store, then enable it via the message bar menu.

Cursor

Settings → Tools & Integrations → MCP → Add HTTP server, and enter the URL above.

GitHub Copilot / VS Code

Open the Command Palette, run "MCP: Open User Configuration", and add:

{
  "servers": {
    "common-room": {
      "type": "http",
      "url": "https://mcp.commonroom.io/mcp"
    }
  }
}

Other HTTP-compatible clients (Windsurf, Zed, Amazon Q): use the same URL and OAuth flow.

Use Cases

Generate an account research brief for an inbound lead: pull engagement signals, recent product activity, and a company snapshot before a discovery call.
Prep for a sales meeting by surfacing a contact's profile, prior touches, and likely objections grounded in Common Room signals.
Build a targeted prospect list using intent and firmographic filters, then export or hand off to outreach.
Draft a personalized outbound email or LinkedIn message anchored to a specific recent signal (docs visit, repo star, community post).
Write meeting notes, new contacts, or segment memberships back into Common Room directly from the AI client.

Example Prompts

"Give me an account brief for Acme Corp: recent signals, engaged contacts, and product usage in the last 30 days."
"Find contacts at Series B fintech companies who visited our pricing page this week and aren't in any active segment."
"Prep me for my 2pm with Jane Doe at Globex: profile, last touches, and three talking points."
"Draft a personalized outbound email to the top 5 engaged contacts at Initech based on their recent activity."
"Create a note on the Acme Corp organization summarizing today's call and tag it with 'Q3 renewal'."

Pros

Official, provider-hosted server with OAuth 2.1; no local install, secrets, or infra to manage.
Read and write support across contacts, organizations, activities, segments, and notes.
Compact, generic tool surface (catalog + list/create/update) that adapts to any object type in the workspace.
Honors Common Room workspace role-based access controls per user.

Limitations

Requires a paid Common Room instance and an account with workspace access; not useful standalone.
Small set of generic tools means the agent has to discover schema via the catalog rather than calling purpose-built endpoints.
Hosted-only; teams that need self-hosting or air-gapped deployments are not supported.

Alternatives

Clay (account/contact enrichment and signal orchestration, via community MCP wrappers).
HubSpot MCP server (CRM-centric reads/writes over contacts, companies, and deals).
Apollo.io or ZoomInfo via their APIs through generic HTTP/MCP bridges for prospecting and contact data.