@incrm-app/mcp-server

Model Context Protocol (MCP) server for InCRM. Enables AI assistants (Claude, ChatGPT, Cursor, Windsurf) to interact with the InCRM API directly.

Installation

npm install -g @incrm-app/mcp-server
# or run directly via npx
npx @incrm-app/mcp-server

Setup

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "incrm": {
      "command": "npx",
      "args": ["@incrm-app/mcp-server"],
      "env": {
        "INCRM_API_URL": "https://api.incrm.app/api/v1",
        "INCRM_API_KEY": "incrm_your-api-key-here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "incrm": {
      "command": "node",
      "args": ["./packages/mcp-server/bin/cli.mjs"],
      "env": {
        "INCRM_API_URL": "https://api.incrm.app/api/v1",
        "INCRM_API_KEY": "incrm_your-api-key-here"
      }
    }
  }
}

Generic MCP Client

{
  "mcpServers": {
    "incrm": {
      "command": "npx",
      "args": ["@incrm-app/mcp-server"],
      "env": {
        "INCRM_API_URL": "https://api.incrm.app/api/v1",
        "INCRM_API_KEY": "incrm_your-api-key-here"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |---|---|---| | INCRM_API_KEY | Yes | API key for authentication (create via InCRM UI or API) | | INCRM_API_URL | No | API base URL (default: https://api.incrm.app/api/v1) |

Available Tools

The MCP server exposes CRUD tools for all InCRM entities:

| Tool Pattern | Description | |---|---| | list_{entity} | List records with pagination, filtering, sorting | | get_{entity} | Get a single record by ID | | create_{entity} | Create a new record | | update_{entity} | Update a record by ID | | delete_{entity} | Delete a record by ID |

Supported Entities

• Clients — CRM contacts and customers
• Invoices — Financial documents
• Quotes — Price proposals
• Products — Physical goods catalog
• Services — Service offerings
• Employees — Team members
• Expenses — Business expenses
• Shipments — Delivery tracking
• Webhooks — Event subscriptions
• API Keys — Authentication keys
• Locations — Business locations

Utility Tools

| Tool | Description | |---|---| | get_capabilities | Get API capabilities, entities, events, rate limits | | get_permissions | Get current user permissions (based on API key) |

Available Resources

| Resource | Description | |---|---| | incrm://api-info | API connection info and available entities | | incrm://webhook-events | List of webhook event types |

Development

# Build
pnpm run build

# Watch mode
pnpm run dev