MCP server URL
https://mcp.habsy.ai/mcpGetting started
Sign in with the same Google account you use in the Habsy mobile app. All data is scoped to your authenticated account.
ChatGPT
- Open ChatGPT (web or desktop).
- Go to Apps / Connectors and search for Habsy, or add the MCP URL above.
- Click Connect and sign in with Google.
- Start a new chat and try: "What's my Habsy profile?"
Claude
- Open Claude and go to Settings → Connectors.
- Add a custom connector with URL:
https://mcp.habsy.ai/mcp - Authorize with your Google account.
- Start a new conversation and ask about your contacts.
Cursor
- Install Habsy from the Cursor Marketplace, or add the MCP URL to your
mcp.json. - Restart Cursor and authorize with Google when prompted.
Sample prompts
Copy these into your AI assistant to get started:
Personal
What's my Habsy profile and subscription?
Search my cards for anyone at Google
Show me my recent scanned cards
List my categories and how many cards are in each
Which integrations are connected?
Organization (org owners only)
List everyone on my Habsy team with account status and card countsRequires organization owner access
Show all cards scanned across my organization
What are our top companies and who scanned the most cards?
Which cards failed to sync to CRM?
How is our email and WhatsApp outreach performing?
What you can do
- Search contacts: by name, company, job title, email, or notes
- Org intelligence: team roster, org-wide cards, analytics, CRM sync logs
- Organize: groups, categories, reminders
- Outreach: email and WhatsApp analytics (when enabled on your plan)
- Integrations: CRM connection status (Zoho, HubSpot, Salesforce, and more)
Available tools (overview)
Default read tools available to all connected users:
| Tool | Description |
|---|---|
get_my_profile | Profile, subscription, categories |
search_cards | Search your business cards |
get_card | Full details for one card |
list_home_cards | Recent scanned cards |
list_groups | Your contact groups |
list_reminders | Follow-up reminders |
list_categories | Categories with counts |
get_subscription | Subscription plan status |
list_org_members | Org team roster (org owner) |
list_org_cards | Org-wide card search (org owner) |
get_org_analytics | Top companies and top scanners (org owner) |
get_crm_sync_logs | CRM sync history (org owner) |
get_org_outreach_analytics | Org email/WhatsApp ROI (org owner) |
get_integration_status | Integrations catalog and status |
get_crm_connection_status | CRM provider connection status |
Additional write, outreach, enrichment, and export tools may be enabled based on your plan and server configuration.
Privacy and security
- Every operation is scoped to your authenticated Google account
- Card images are not transmitted, text fields only
- OAuth tokens expire automatically; disconnect anytime from your AI app settings
- Privacy policy · Terms of service
Troubleshooting
| Issue | Solution |
|---|---|
| Unauthorized | Disconnect and reconnect the connector; sign in again with your Habsy Google account |
| Org tools return access denied | Org-wide tools require organization owner access (main org account) |
| Rate limit exceeded | Wait about one minute and try again |
| Tool not found | Some tools may be plan-gated; contact support@habsy.ai |
Need help?
Email support@habsy.ai or visit our support page.