Skip to main content
Glama
capsulecrm-mcp

capsulecrm-mcp

by MonadsAG

๐Ÿš€ CapsuleCRM MCP Server

Transform your CRM workflow with AI! ๐Ÿค–โœจ Connect Claude directly to your CapsuleCRM account for natural language customer and sales management.

๐ŸŽฏ What it does

  • ๐Ÿ—ฃ๏ธ Talk to your CRM in plain English - "Show me all VIP customers from last month"

  • ๐Ÿ” Smart search and filtering - Find exactly what you need with powerful queries

  • ๐Ÿ“Š Get instant insights - Query sales pipeline, customer data, and tasks

  • โšก Automate routine tasks - Create, update, and manage CRM data through conversation

Related MCP server: SalesDrive MCP Server

๐ŸŽ‰ Installation

๐Ÿ–ฅ๏ธ Claude Desktop

  1. ๐Ÿ“ฅ Download the capsulecrm-mcp.dxt file

  2. ๐Ÿ‘† Double-click to install in Claude Desktop

  3. ๐Ÿ”‘ Enter your CapsuleCRM API key when prompted

  4. ๐ŸŽŠ Start using natural language CRM commands!

๐Ÿ’ป Command line (uvx)

Runs the server over stdio without the .dxt, e.g. for an MCP hub. Pin a tag or commit:

CAPSULECRM_ACCESS_TOKEN=<your-token> uvx --from git+https://github.com/MonadsAG/capsulecrm-mcp@<tag> capsulecrm-mcp

From a local checkout: uvx --from . capsulecrm-mcp. Without CAPSULECRM_ACCESS_TOKEN the server exits with code 1.

๐Ÿ”‘ Getting Your API Key

  1. ๐ŸŒ Log in to your CapsuleCRM dashboard

  2. โš™๏ธ Go to Account Settings โ†’ API

  3. โœจ Generate a new API token

  4. ๐Ÿ’พ Copy and store securely (you won't see it again!)

๐Ÿ’ก Usage Examples

๐Ÿ‘ฅ Customer Management

  • ๐Ÿ” "Find all VIP customers in New York"

  • ๐Ÿ“… "Show me customers we haven't contacted in 30 days"

  • โž• "Create a new person: John Smith, john@acme.com"

๐Ÿ’ฐ Sales Pipeline

  • ๐Ÿ’Ž "What's the total value of our open opportunities?"

  • ๐Ÿ“ˆ "Show me deals closing this quarter"

  • ๐ŸŽฏ "Create a new opportunity for Acme Corp worth $25,000"

โœ… Task Management

  • โฐ "What tasks are overdue?"

  • ๐Ÿ‘ฉโ€๐Ÿ’ผ "Show me all tasks assigned to Sarah"

  • ๐Ÿ“ "Create a follow-up task for next Friday"

๐Ÿ”ฎ Advanced Filtering

Ask complex questions like:

  • ๐Ÿ’ต "Find opportunities worth more than $50,000 that are in proposal stage"

  • ๐Ÿท๏ธ "Show me customers added in the last 30 days with hot-lead tags"

  • ๐Ÿ‘ฅ "List all overdue tasks assigned to my team"

๐ŸŽช Capabilities

๐Ÿ‘ฅ Customer Management (Parties)

  • ๐Ÿ‘€ View, create, update people and organizations

  • ๐Ÿ”Ž Search by name, email, phone, address

  • ๐Ÿท๏ธ Filter by tags, location, contact info

๐Ÿ’ผ Sales Pipeline (Opportunities)

  • ๐Ÿ“Š Track deals and progress through stages

  • ๐ŸŽฒ Automatic probability-weighted values

  • ๐Ÿ” Comprehensive filtering and search

  • ๐Ÿ’ฐ Revenue insights and reporting

โœ… Task Management

  • ๐Ÿ“‹ Create, view, and update tasks

  • ๐ŸŽฏ Filter by status, assignee, due dates

  • ๐Ÿ”— Link tasks to customers and deals

๐ŸŽฏ Pipeline Configuration

  • ๐Ÿ“ˆ View all pipeline milestones

  • ๐Ÿš€ Track opportunity progress through stages

๐Ÿ”ง Search Operators

  • ๐Ÿ” contains - Find partial matches

  • ๐ŸŽฏ starts with / ends with - Prefix/suffix matching

  • ๐Ÿ“… is after / is before - Date comparisons

  • ๐Ÿ“Š is greater than / is less than - Numerical filtering

  • โฐ is within last - Recent time periods

๐Ÿšจ Troubleshooting

๐Ÿšซ Extension won't start:

  • โœ… Verify your API key is correct

  • ๐ŸŒ Check internet connection to CapsuleCRM

  • ๐Ÿ Ensure Python 3.11+ is installed

๐Ÿ“ฆ "No module found" errors:

  • ๐ŸŽ Dependencies are bundled in the extension

  • ๐Ÿ”„ Try reinstalling the extension

โš ๏ธ API errors:

  • ๐Ÿ” Verify API key permissions in CapsuleCRM

  • ๐Ÿšฆ Check rate limits aren't exceeded

๐Ÿ› Debug Mode: Set environment variable LOG_LEVEL=DEBUG for detailed logging.

๐Ÿ›ก๏ธ Security & Privacy

  • ๐Ÿ” Uses official CapsuleCRM API with secure token authentication

  • ๐Ÿšซ No data storage - acts as real-time bridge

  • ๐Ÿ”’ Environment variables for secure token storage

  • โœ… Full read/write permissions as configured in CapsuleCRM

๐Ÿ“„ License

MIT License - see LICENSE file for details.

๐Ÿข About

Developed by Monads AG - specialists in AI automation and business process optimization.


Ready to transform your CRM experience? Let's make data management fun! ๐ŸŽ‰๐Ÿš€

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to access and query Capsule CRM data (contacts, opportunities, support cases, tasks, projects, products) through natural language, with read-only security.
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with SalesDrive CRM, allowing order management, product queries, and more through natural language.
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to Freshsales CRM, enabling natural language queries and CRUD operations on contacts, deals, accounts, and more.
      MIT