• IDENTITY
  • DISCOVERY
  • CONTEXT
  • ACTION

How to retrieve contact profiles with your AI

Connect Common Room to your AI client to pull user data. Once linked, you can query contact details and tags without leaving your chat.

Ask AI about this page

Short answer

How can I get contact info from Common Room using AI?

Your AI uses specific tools to look up users by email, search your contact list, or pull custom tags. You get these details immediately in your chat. This allows you to identify key users and their attributes instantly.

Data outcomes

What you get from your queries

The information your AI pulls from Common Room.

IDENTITY

Specific user lookups

The AI finds a single profile using an email address. You get the exact data tied to that specific person.

DISCOVERY

Broad contact searches

The AI scans your database for groups of people. You can find lists of users that match specific criteria.

CONTEXT

Tag retrieval

The AI pulls the specific labels and tags attached to a profile. This tells you how that user is categorized.

ACTION

Human review needed

The AI provides the data, but you decide how to use it. You remain in control of any follow-up outreach or CRM updates.

The workflow

What your AI does when you ask for contact data.

Your agent translates your questions into specific tool calls to Common Room.

  1. Locate the user

    If you provide an email, the AI targets that specific individual to pull their profile.

    get_contact_by_email

  2. Scan the database

    For broader questions, the AI searches through your contact list to find matching profiles.

    search_contacts

  3. Identify attributes

    The AI looks up the specific labels and tags assigned to a user to give you context.

    get_contact_tags

  4. Deliver the profile

    The AI compiles the requested information into a readable format in your chat window.

    get_contact_by_emailsearch_contactsget_contact_tags

Try it

Copy these to start.

Use these prompts to test the connection.

Starting points

These are templates. Swap out the bracketed info with your actual contact emails or names.

Common Room Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_IKrxCPx6lEPWctuoHr8ylMStkNoCktDEp1aNa6vt/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Common Room capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "common-room-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_IKrxCPx6lEPWctuoHr8ylMStkNoCktDEp1aNa6vt/mcp"
    }
  }
}
Copy into chat04

  • Find the contact profile for alex.smith@example.com

  • Search for all contacts in my Common Room list

  • What are the tags for the user with email jordan.lee@company.com?

  • List all contacts that have the 'VIP' tag

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Common Room once, then ask.

Follow the link to authorize the connection. Your credentials stay encrypted, and you can immediately start asking questions in your preferred AI client.

Connect Common Room to your AI

FAQ

How this task behaves

  • 01

    Can the AI update contact tags in Common Room?

    No. The AI can only read existing tags and profile information. You must make changes manually in Common Room.

  • 02

    Can I delete contacts using my AI?

    No. This MCP is designed for data retrieval only. It does not have the capability to delete or remove any records.

  • 03

    How does the AI find a user if I don't have their email?

    The AI uses the search function to look through your contact list based on the names or other criteria you provide.

  • 04

    Does the AI see all my Common Room data?

    The AI only accesses the specific data requested through the tools provided in the manifest.

  • 05

    Can the AI send an email to a contact it finds?

    No. The AI can retrieve the email address, but it cannot send messages or initiate outreach.

  • More questions about Common Room? The Connector page answers them. See everything the Common Room Connector can do

Connect Common Room to Claude, Cursor, ChatGPT & more