Aspro Cloud MCP

MCP server for Aspro Cloud — work with CRM deals and tasks directly from AI assistants (Claude, Cursor, etc.).

Tools

Deals (CRM)

Tool	Description
list_leads	List deals with filters (pipeline, stage, assignee, status)
get_lead	Get deal details by ID
create_lead	Create a new deal
update_lead	Update an existing deal
delete_lead	Delete a deal
list_pipelines	List all sales pipelines
list_pipeline_stages	List pipeline stages

Tasks

Tool	Description
list_tasks	List tasks with filters (responsible, status, type, module binding)
get_task	Get task details by ID
create_task	Create a new task
update_task	Update an existing task
delete_task	Delete a task
list_workflows	List all task workflows
list_workflow_stages	List workflow stages

Users

Tool	Description
search_users	Search users by name (returns id for use in responsible_id / assignee_id)
get_user	Get user details by ID

Setup

Prerequisites

• Node.js 18+
• Aspro Cloud account with API access
• API key from your Aspro Cloud settings

Configuration

Two environment variables are required:

Variable	Description	Example
ASPRO_COMPANY	Your company subdomain	mycompany
ASPRO_API_KEY	API key from Aspro Cloud settings	abc123...

Your company subdomain is the part before .aspro.cloud in your workspace URL.

Usage in Cursor

Add to your Cursor MCP configuration (~/.cursor/mcp.json or .cursor/mcp.json in your project):

Via npx (recommended, no installation needed)

{
  "mcpServers": {
    "aspro-cloud": {
      "command": "npx",
      "args": ["-y", "github:kazan-project-manufactory/aspo-cloud-mcp"],
      "env": {
        "ASPRO_COMPANY": "your_company",
        "ASPRO_API_KEY": "your_api_key"
      }
    }
  }
}

Via local path (if cloned)

git clone https://github.com/kazan-project-manufactory/aspo-cloud-mcp.git
cd aspo-cloud-mcp
npm install

{
  "mcpServers": {
    "aspro-cloud": {
      "command": "node",
      "args": ["/path/to/aspo-cloud-mcp/dist/index.js"],
      "env": {
        "ASPRO_COMPANY": "your_company",
        "ASPRO_API_KEY": "your_api_key"
      }
    }
  }
}

Usage in Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "aspro-cloud": {
      "command": "npx",
      "args": ["-y", "github:kazan-project-manufactory/aspo-cloud-mcp"],
      "env": {
        "ASPRO_COMPANY": "your_company",
        "ASPRO_API_KEY": "your_api_key"
      }
    }
  }
}

Example prompts

Find user Ivan Petrov and assign him a task to prepare the contract by Friday

Show me all open deals in the "New Clients" pipeline

Create a deal "Website Redesign" for client Vasily Sidorov with budget 150000

List all tasks assigned to me that are in progress

Development

npm run build    # compile TypeScript
npm run dev      # watch mode

License

MIT