customer-intelligence-hub
Customer Intelligence Hub: AI Agents for CRM Analytics, Slack & Marketing Automation | LangGraph & MCP
Install / Use
claude mcp add Gabrielm3 -- npx -y github:Gabrielm3/customer-intelligence-hubIf the server publishes to npm under a different name, use that package instead ā check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AutomationSupported Platforms
Our assessment of customer-intelligence-hub
customer-intelligence-hub scores 68/100 on our quality scale, 2586th of 2,758 Automation skills we index.
Its MCP Server is 6.5 KB long, well organised into 23 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 14 months ago. Expect some instructions to reference tool versions or APIs that have since changed.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 68/100, with 3 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit ā read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-21. It catches known dangerous patterns, not every risk ā read a skill before letting an agent act on it.
customer-intelligence-hub compared with similar skills
All 4 of these similar skills score higher than customer-intelligence-hub; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| customer-intelligence-hub (this skill)by Gabrielm3 | 68 | 3 | 14mo ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.3k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.5k | today | CLAUDE.md |
Frequently asked questions
- How do I install customer-intelligence-hub?
- Run
claude mcp add Gabrielm3 -- npx -y github:Gabrielm3/customer-intelligence-hub. The install tabs above show the steps for each supported agent. - Which AI agents does customer-intelligence-hub work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is customer-intelligence-hub safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It declares no license and scores 68/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is customer-intelligence-hub still maintained?
- The repository was last updated about 14 months ago. Expect some instructions to reference tool versions or APIs that have since changed.
Skill content
View source on GitHubCustomer Intelligence Hub - CRM
An intelligent Customer Relationship Management system powered by AI agents, designed to analyze customer data, create targeted marketing campaigns, and provide actionable business insights.
Overview
Customer Intelligence Hub is an AI-powered system that combines customer data analysis with automated marketing capabilities. It uses LangGraph for agent orchestration, PostgreSQL for data storage, and Model Context Protocol (MCP) for tool integration.
Architecture
graph TB
A[š¤ User] --> B[š¤ Neo AI Agent]
B --> C[š§ MCP Tools Layer]
C --> D[šļø PostgreSQL Server]
C --> E[š§ Marketing Server]
C --> F[š¬ Slack Server]
D --> G[(š Customer Database)]
G --> H[š„ Customers]
G --> I[š° Transactions]
G --> J[š RFM Analysis]
G --> K[šÆ Campaigns]
E --> L[š Campaign Creation]
E --> M[āļø Email Automation]
F --> N[š Team Notifications]
F --> O[š” Insights Sharing]
B --> P[š LangSmith Tracking]
Key Features
- AI-Powered Customer Analysis: Automated RFM (Recency, Frequency, Monetary) analysis
- Smart Marketing Campaigns: Create and manage targeted campaigns based on customer segments
- Real-time Data Queries: Natural language interface to query customer and sales data
- Slack Integration: Share insights and updates with your team automatically
- Comprehensive Tracking: Full observability with LangSmith integration
Benefits
- šÆ Targeted Marketing: Identify high-value customers and create personalized campaigns
- š Data-Driven Insights: Get instant answers about customer behavior and sales performance
- ā” Automation: Reduce manual work with automated campaign creation and email sending
- š„ Team Collaboration: Keep everyone informed with Slack notifications
- š Performance Tracking: Monitor all AI interactions and decisions with LangSmith
- š Scalable Architecture: Built with modern tools for enterprise-grade performance
Quick Start
Prerequisites
- Docker and Docker Compose
- OpenAI API Key
- LangSmith API Key (optional, for tracking)
- Slack Bot Token (optional, for Slack integration)
Running with Docker (Recommended)
-
Clone the repository
git clone https://github.com/Gabrielm3/customer-intelligence-hub cd customer-intelligence-hub -
Configure environment variables
cp .env.example .env # Edit .env with your API keys -
Start the system
docker-compose up --build -d -
Generate and import sample data
# Generate CSV files from raw data (run once) docker-compose exec crm-agent bash -c "cd database && uv run python generate_data_tables.py" # Import CSV files to database docker-compose exec crm-agent bash -c "cd database && uv run python import_data.py" -
Start the interactive CLI
docker-compose exec crm-agent uv run python cli/interactive_cli.py
Running Locally
-
Install dependencies
uv sync -
Set up PostgreSQL database
# Start PostgreSQL locally or use Docker docker run -d --name postgres \ -e POSTGRES_DB=crm_database \ -e POSTGRES_USER=crm_user \ -e POSTGRES_PASSWORD=crm_password \ -p 5432:5432 postgres:15-alpine -
Configure environment
cp .env.example .env # Update DATABASE_URL for local PostgreSQL -
Initialize database
cd database # Generate CSV files from raw data uv run python generate_data_tables.py # Import to database uv run python import_data.py -
Run the CLI
uv run python cli/interactive_cli.py
Usage Examples
Once the system is running, you can ask Neo (the AI agent) questions like:
- Customer Analysis: "How many customers do we have?" or "Show me the top 5 customers by spending"
- Product Insights: "What are our best-selling products?" or "Which products have the highest margins?"
- Marketing Campaigns: "Create a loyalty campaign for VIP customers" or "Send a re-engagement email to inactive customers"
- RFM Analysis: "Show me the RFM analysis of our customers" or "Who are our most valuable customers?"
Configuration
Environment Variables
| Variable | Description | Required |
|----------|-------------|----------|
| OPENAI_API_KEY | OpenAI API key for AI agent | Yes |
| DATABASE_URL | PostgreSQL connection string | Yes |
| LANGSMITH_API_KEY | LangSmith tracking (optional) | No |
| SLACK_BOT_TOKEN | Slack integration (optional) | No |
| SLACK_TEAM_ID | Slack team ID (optional) | No |
MCP Servers
The system uses three MCP servers:
- PostgreSQL: For database queries and analytics
- Marketing: For campaign creation and email automation
- Slack: For team communication and notifications
Project Structure
customer-intelligence-hub/
āāā src/crm_agent/ # Core agent logic
ā āāā agent_graph.py # LangGraph workflow
ā āāā system_prompts.py # AI agent prompts
ā āāā mcp_servers/ # MCP server configurations
āāā cli/ # Interactive command-line interface
āāā database/ # Database setup and sample data
āāā docker-compose.yml # Docker orchestration
āāā pyproject.toml # Python dependencies
Troubleshooting
Common Issues
Database Connection Error
# Check if PostgreSQL is running
docker-compose ps
# Restart if needed
docker-compose restart postgres
Missing Dependencies
# Rebuild containers
docker-compose down
docker-compose up --build
Empty Database
# Re-generate and import sample data
docker-compose exec crm-agent bash -c "cd database && uv run python generate_data_tables.py"
docker-compose exec crm-agent bash -c "cd database && uv run python import_data.py"
Monitoring
- LangSmith Dashboard: https://smith.langchain.com/ (project:
customer-intelligence-hub) - Database Status:
docker-compose exec postgres psql -U crm_user -d crm_database -c "\dt" - Container Logs:
docker-compose logs crm-agent
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Related Skills
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu ā one CLI, zero API fees.
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.3kš The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.5kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit ā see the Safety scan above for what the skill file itself contains.
