BuildBetter MCP Server - Complete Guide
This guide covers everything you need to know about the BuildBetter MCP Server, from setup to what you can ask and troubleshooting.
Overview
The BuildBetter MCP Server lets AI assistants like Claude and ChatGPT securely access your BuildBetter data. Once connected, you can ask questions about your calls, customer feedback, contacts, and companies in plain language — the assistant handles everything behind the scenes.Read-Only
Your data can never be modified through the MCP server
No Local Setup
Nothing to install — just add a URL and sign in
Sign In With BuildBetter
Uses your existing BuildBetter account
Live Data
Always reflects your latest BuildBetter data
Getting Started
Prerequisites
- A BuildBetter account
- A supported AI client: Claude Desktop, Claude Code, Cursor, or ChatGPT
How Sign-In Works
When you first connect, your AI client will open a browser window where you sign in with your BuildBetter account. After that, you’re connected — no API keys to manage or rotate.Setup Instructions
Claude Desktop
Claude Code
Cursor
ChatGPT
What You Can Ask About
Once connected, just ask questions in plain language. Here’s what data is available:Calls & Meetings
Calls & Meetings
Access your recorded calls, meetings, and conversations — including summaries, participants, and timestamps.Example questions:
- “Show me my 10 most recent customer calls”
- “Find all calls with Acme Corp from this month”
- “Summarize yesterday’s demo call with the engineering team”
- “Which calls had the most participants this week?”
Customer Signals & Feedback
Customer Signals & Feedback
Search through extracted insights from your conversations — issues, feature requests, praise, complaints, and more.Example questions:
- “What issues did customers raise this week?”
- “Show me all feature requests from the last 30 days”
- “Find negative feedback about our onboarding process”
- “What are customers praising us for?”
People & Contacts
People & Contacts
Look up customers and team members, and see their associated calls and feedback.Example questions:
- “Find all conversations involving John Smith”
- “Who are our most active customer contacts?”
- “Show me all feedback from people at Acme Corp”
Companies & Accounts
Companies & Accounts
Access company information and see all associated people, calls, and signals.Example questions:
- “Show me everything we know about Acme Corp”
- “Which companies have raised the most issues recently?”
- “List all companies we’ve talked to this quarter”
Documents
Documents
Search and retrieve AI-generated documents and imported content like Notion pages.Example questions:
- “Find all documents about our onboarding process”
- “Show me the latest competitive analysis doc”
- “Search for documents imported from Notion”
Knowledge Base
Knowledge Base
Browse and search your internal knowledge base wiki pages.Example questions:
- “What’s in our knowledge base about pricing?”
- “Show me the custom context page”
- “Find knowledge pages about workflows”
Advanced GraphQL Queries
Advanced GraphQL Queries
Run custom queries against the full BuildBetter data model for advanced use cases.Example questions:
- “Query the last 10 interviews with their tags”
- “What GraphQL types are available?”
- “Show me all fields on the extraction type”
Use Cases by Team
Customer Success
Weekly Customer Health Reports
“Show me all critical issues mentioned by Enterprise customers in the last 7 days”
Account Reviews
“Find all conversations with Acme Corp and summarize their main pain points”
Churn Risk Analysis
“Identify customers who’ve expressed frustration in recent calls”
Product Management
Feature Request Tracking
“List all feature requests mentioned in the last month, grouped by theme”
User Feedback Analysis
“Find all feedback about our onboarding process”
Competitive Intelligence
“Show mentions of competitors in customer calls”
Engineering
Bug Report Aggregation
“Find all technical issues mentioned by customers this week”
Integration Feedback
“Search for problems users are having with our API”
Performance Complaints
“List all mentions of slow performance or timeouts”
Leadership
Strategic Insights
“Summarize the top 5 themes from customer conversations this quarter”
Market Trends
“What new use cases are customers asking about?”
Customer Sentiment
“How has overall customer sentiment changed over the last 30 days?”
More Example Questions
- Recent Activity
- Issue Investigation
- Customer Deep Dive
- Sentiment Analysis
- Feature Requests
- Team Performance
“Show me the 10 most recent customer calls”
Security & Privacy
Read-Only Access
- The MCP server provides read-only access to your data
- No one can modify, delete, or create data through this connection
Authentication
- You sign in with your existing BuildBetter account — no separate credentials
- Access is scoped to your organization’s data only
- No API keys to manage, rotate, or risk leaking
- Sessions can be revoked from your BuildBetter account settings
Network Security
- All connections use HTTPS encryption
- No data is stored or cached by the MCP server
Best Practices
Limitations
- Data Access
- Query Limits
- What's Not Supported
- Read-only — Cannot create, update, or delete data
- Organization-scoped — Access limited to your organization’s data
- No bulk exports — Designed for targeted questions, not data dumps
Troubleshooting
Connection Issues
Connection refused or timeout errors
Connection refused or timeout errors
- Check that you have internet connectivity
- Verify the URL is
https://mcp.buildbetter.app - Try restarting your AI client
Authentication errors
Authentication errors
- Ensure you’re signing in with the correct BuildBetter account
- Try signing out and back in to refresh your session
- Check that your BuildBetter account is active
Client Issues
MCP server not appearing in Claude Desktop
MCP server not appearing in Claude Desktop
- Open Settings > Connectors and verify the BuildBetter connector is listed
- Try removing and re-adding the connector
- Restart Claude Desktop completely
Sign-in popup not appearing
Sign-in popup not appearing
- Check that your browser is not blocking popups
- Ensure your default browser is set correctly
- Try manually navigating to the sign-in URL if shown in logs
Data Issues
No data returned
No data returned
- Verify you have data in your BuildBetter account
- Try broadening your question (e.g., remove date filters)
Unexpected results
Unexpected results
- Try rephrasing your question to be more specific
- Ask the assistant to clarify what data it found
Support
Account Settings
Manage your account and connected apps
Contact Support
Email support@buildbetter.ai for help
Last updated March 2026