io.github.Techmatic-sys/indiamart-mcp-server
Claude AI for IndiaMART leads - fetch, search, sync and track pipeline.
Ask AI about io.github.Techmatic-sys/indiamart-mcp-server
Powered by Claude ยท Grounded in docs
I know everything about io.github.Techmatic-sys/indiamart-mcp-server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
๐ฎ๐ณ IndiaMART MCP Server
A fully functional Model Context Protocol (MCP) server that connects Claude AI to IndiaMART's Lead Management API. Fetch, search, analyze, and manage your IndiaMART buyer leads using natural language.
โก Quick Install (60 seconds)
git clone https://github.com/Techmatic-sys/indiamart-mcp-server.git
cd indiamart-mcp-server
pip install -r requirements.txt
Then add to your Claude Desktop config and you're done. Full setup below.
โจ Features
- 10 MCP Tools โ 8 read tools + 2 write tools for complete CRM
- Pull Leads โ Fetch leads from IndiaMART for any date range
- Pipeline Management โ Track leads through sales stages (new โ won)
- Notes โ Attach private notes to leads for context
- Real-time Webhook โ Receive leads instantly via IndiaMART's Push API
- Local Database โ All leads stored in SQLite for fast offline access
- Analytics โ Get stats by city, product, and date
- Search โ Find leads by keyword in product or message
- Export CSV โ Export leads for spreadsheets and reporting
- Draft Replies โ Generate professional buyer replies instantly
- Input Validation โ Pydantic schemas prevent malformed queries
- Retry Logic โ Exponential backoff on API failures
- Claude Desktop Ready โ Plug-and-play config included
๐ Prerequisites
- Python 3.10+ (Download)
- IndiaMART Seller Account with Lead Manager access
- IndiaMART CRM API Key (see below)
- Claude Desktop (optional, for AI-powered lead management)
๐ Installation
1. Clone or Download
git clone https://github.com/Techmatic-sys/indiamart-mcp-server.git
cd indiamart-mcp-server
2. Create Virtual Environment (recommended)
python -m venv venv
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate
3. Install Dependencies
# MCP server only (lightweight, 4 packages)
pip install -r requirements.txt
# Full SaaS web app (includes FastAPI, uvicorn, etc.)
pip install -r requirements-saas.txt
4. Configure Environment
# Copy the example env file
cp .env.example .env # Linux/macOS
copy .env.example .env # Windows
# Edit .env with your credentials
๐ How to Get Your IndiaMART API Key
- Log in to IndiaMART Seller Dashboard
- Go to Lead Manager โ Settings (โ๏ธ icon)
- Navigate to CRM Integration or API Settings
- Generate or copy your CRM API Key (
glusr_crm_key) - Note your GLID (Global Login ID) from your account profile
- Paste both values into your
.envfile
Note: The API key gives access to your leads. Keep it secret!
โถ๏ธ Running the MCP Server
# Standard run (Claude Desktop starts this automatically)
python mcp_server.py
# Check version
python mcp_server.py --version
# Health check (verify DB connectivity)
python mcp_server.py --health
๐ฅ๏ธ Connecting to Claude Desktop
1. Locate Claude Desktop Config
| OS | Path |
|---|---|
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
2. Add the MCP Server
{
"mcpServers": {
"indiamart": {
"command": "python",
"args": ["mcp_server.py"],
"cwd": "/ABSOLUTE/PATH/TO/indiamart-mcp-server",
"env": {
"INDIAMART_API_KEY": "your_crm_api_key_here",
"INDIAMART_GLID": "your_glid_here"
}
}
}
}
Replace cwd with your actual path:
- Windows:
"C:\\Users\\YourName\\indiamart-mcp-server" - macOS:
"/Users/yourname/indiamart-mcp-server" - Linux:
"/home/yourname/indiamart-mcp-server"
3. Restart Claude Desktop
Close and reopen Claude Desktop. You should see the IndiaMART tools available in the tools menu.
๐ค Connecting to Claude Code
Option 1: CLI (Recommended)
claude mcp add indiamart -- python /ABSOLUTE/PATH/TO/indiamart-mcp-server/mcp_server.py
Then set your environment variables:
# In your shell profile or before launching Claude Code
export INDIAMART_API_KEY="your_crm_api_key_here"
export INDIAMART_GLID="your_glid_here"
Option 2: Manual Config
Add to your .claude/settings.json (project-level) or ~/.claude/settings.json (global):
{
"mcpServers": {
"indiamart": {
"command": "python",
"args": ["/ABSOLUTE/PATH/TO/indiamart-mcp-server/mcp_server.py"],
"env": {
"INDIAMART_API_KEY": "your_crm_api_key_here",
"INDIAMART_GLID": "your_glid_here"
}
}
}
}
Replace the path with your actual absolute path to mcp_server.py.
Verify Connection
Once connected, ask Claude Code:
- "Sync my latest IndiaMART leads"
- "Show me leads from the last 24 hours"
- "What are my lead statistics?"
๐ฆ Connecting to OpenClaw
OpenClaw is a self-hosted AI agent platform. Your IndiaMART leads become a native skill in OpenClaw, accessible from any interface OpenClaw supports.
1. Find your OpenClaw config file
| OS | Path |
|---|---|
| Linux/macOS | ~/.openclaw/openclaw.json |
| Windows | C:\Users\YourName\.openclaw\openclaw.json |
2. Add the IndiaMART skill
Open the config and add under skills.mcpServers:
{
skills: {
mcpServers: {
indiamart: {
command: "python",
args: ["mcp_server.py"],
cwd: "/absolute/path/to/indiamart-mcp-server",
env: {
INDIAMART_API_KEY: "your_crm_api_key_here",
INDIAMART_GLID: "your_glid_here"
}
}
}
}
}
See
openclaw-config-example.json5at the repo root for a ready-to-copy template.
3. Restart the OpenClaw gateway
openclaw gateway restart
4. Verify it loaded
openclaw status --all
# You should see "indiamart" listed with 10 tools
Remote OpenClaw (VPS / EC2)
Run the MCP server in SSE mode on your server:
python mcp_server.py --transport sse --host 0.0.0.0 --port 8000
Then point your OpenClaw config to http://your-server-ip:8000.
๐ฌ Example Prompts
| Prompt | What It Does |
|---|---|
| "Show me all leads from the last 24 hours" | Syncs and displays recent leads |
| "How many leads did I get this week and from which cities?" | Shows lead statistics |
| "Search for leads asking about steel pipes" | Keyword search in product/message |
| "Draft a reply for lead ID IML123456789" | Generates professional buyer reply |
| "Move lead IML123 to qualified stage" | Updates pipeline stage |
| "Add a note to lead IML123: Very interested in bulk order" | Attaches a note |
| "Export all leads from January 2026 as CSV" | Exports leads in CSV format |
| "Sync my latest IndiaMART leads" | Pulls latest leads into local DB |
๐ ๏ธ Available MCP Tools (10 Total)
Read Tools (8)
| Tool | Description |
|---|---|
tool_get_leads_by_date | Fetch leads from IndiaMART for a date range |
tool_get_recent_leads | Get leads from the last N hours |
tool_get_lead_stats | Analytics: totals, by city, product, and date |
tool_search_leads | Search leads by keyword |
tool_get_lead_by_id | Full details of a specific lead |
tool_draft_reply | Draft a professional reply for a buyer |
tool_export_leads_csv | Export leads as CSV |
tool_sync_latest_leads | Sync latest from IndiaMART to local DB |
Write Tools (2 โ NEW)
| Tool | Description |
|---|---|
tool_update_lead_stage | Move leads through pipeline (new โ contacted โ qualified โ won/lost) |
tool_add_note | Attach private notes to leads for follow-up tracking |
๐ Project Structure
indiamart-mcp-server/
โโโ ๐ mcp_server.py โ SINGLE entry point
โโโ ๐ smithery.yaml โ Smithery.ai marketplace manifest
โโโ ๐ pyproject.toml โ Python package config
โโโ ๐ requirements.txt โ MCP only (5 packages)
โโโ ๐ requirements-saas.txt โ Web app deps
โโโ ๐ README.md โ This file
โโโ ๐ CHANGELOG.md โ Version history
โโโ ๐ LICENSE โ MIT License
โโโ ๐ .env.example โ Annotated credential guide
โโโ ๐ .gitignore โ Git ignore rules
โโโ ๐ docker-compose.yml โ Full stack Docker setup
โ
โโโ ๐ mcp_tools/ โ Core MCP Package
โ โโโ __init__.py
โ โโโ ๐ง tools.py โ 10 MCP tools with rich docstrings
โ โโโ ๐ schemas.py โ Pydantic validation + response types
โ โโโ ๐ http_client.py โ Resilient API client with retry
โ โโโ ๐พ database.py โ SQLite operations
โ โโโ ๐ auth.py โ API key helpers
โ โโโ ๐ณ Dockerfile โ MCP server Docker image
โ
โโโ ๐ saas/ โ SaaS Web App (FastAPI)
โ โโโ ...
โ
โโโ ๐ tests/ โ Test suite
โ โโโ conftest.py โ pytest fixtures
โ โโโ test_tools.py โ Validation + integration tests
โ
โโโ ๐ .github/ โ CI/CD
โ โโโ workflows/ci.yml
โ
โโโ ๐ docs/ โ Documentation
โโโ tools.md
โโโ examples.md
๐ง Troubleshooting
"INDIAMART_API_KEY is not set"
- Make sure you've created a
.envfile (not just.env.example) - Check that the key is correct and not expired
- Verify the
.envfile is in the project root directory
Claude Desktop doesn't show IndiaMART tools
- Restart Claude Desktop completely (quit + reopen)
- Check
claude_desktop_config.jsonfor syntax errors (valid JSON?) - Verify the
cwdpath is correct andmcp_server.pyexists there - Check Claude Desktop logs for MCP connection errors
Date format errors
- Supported formats:
YYYY-MM-DD,DD-MM-YYYY,DD/MM/YYYY,DD-Mon-YYYY - Example:
2026-01-15,15-01-2026,15-Jan-2026
๐ License
MIT License. Use freely for your business.
๐ค Contributing
- Fork the repository
- Create a feature branch:
git checkout -b feature/my-feature - Commit changes:
git commit -m "Add my feature" - Push:
git push origin feature/my-feature - Open a Pull Request
Built with โค๏ธ for Indian sellers on IndiaMART
