Cumulocity MCP Server

by cumulocity-iot

8 stars

174 downloads

Not rated

GitHub

About

Access the Cumulocity IoT platform to manage devices, measurements, and alarms.

Details

Author: cumulocity-iot
GitHub stars: 8
Downloads: 174
Categories: Cloud Service, Other, Infrastructure
Tags: #iot, #data-analysis

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Cumulocity MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

From the repository

Building The Microservice Deployment Package

- Ensure you have Docker and zip installed on your system.
- Run the provided build script to create the deployment package:

- Build the Docker image for the microservice
- Save the image asimage.tarin thedocker/directory
- Packageimage.tarandcumulocity.jsonintodocker/mcp-server-c8y.zip
- Log in to your Cumulocity tenant as a user with microservice deployment permissions.
- Navigate toAdministration > Ecosystem > Microservices.
- ClickAdd microserviceand upload themcp-server-c8y.zipfile from thedocker/directory.
- Wait for the microservice to be deployed and started. You should see its status as "Available" once ready.
- The microservice will be accessible under your tenant's service URL, typically:https://<your-tenant>.cumulocity.com/service/mcp-server-c8y/mcp/

For more details on Cumulocity microservice deployment, see the](https://docs.astral.sh/uv/guides/tools/)official documentation.

This MCP Server can be used with Claude Desktop to enable Claude to interact with your Cumulocity IoT platform. Follow these steps to set it up:

Configure Claude Desktop to use this MCP Server:

- Open Claude Desktop
- Click on the Claude menu and select "Settings..."
- Navigate to "Developer" in the left-hand bar
- Click "Edit Config"

Add the following configuration to yourclaude_desktop_config.json:

"mcpServers": { "mcp-c8y": { "command": "uvx", "args": [ "mcp-server-c8y", "--transport", "stdio" ], "env": { "C8Y_BASEURL": "https://your-cumulocity-instance.com", "C8Y_TENANT": "your-tenant-id", "C8Y_USER": "<your-username>", "C8Y_PASSWORD": "<your-password>" } } }

Replace the following placeholders with your actual values:

- https://your-cumulocity-instance.com: Your Cumulocity instance URL
- your-tenant-id: Your Cumulocity tenant ID
- your-username: Your Cumulocity username
- your-password: Your Cumulocity password

You should now see a hammer icon in the bottom right corner of the input box. Click it to see the available Cumulocity tools.

For more detailed information about using MCP Servers with Claude Desktop, visit theofficial MCP documentation.

If you are using Cursor and have deployed your MCP Server to a Cumulocity tenant, you can configure your MCP server connection with a.cursor/mcp.jsonfile. Example (with sensitive data anonymized):

{ "mcpServers": { "Cumulocity": { "url": "https://your-cumulocity-instance.com/service/mcp-server-c8y/mcp/", "headers": { "Authorization": "Basic <YOUR_BASE64_AUTH_TOKEN>" } } } }

- https://your-cumulocity-instance.com: Your Cumulocity instance URL
- Replace<YOUR_BASE64_AUTH_TOKEN>with your actual Base64-encoded credentials. Never commit real credentials to version control.

We welcome contributions from everyone! Here's how you can contribute to this project:
- Fork the repository
- Create a new branch for your feature or bugfix
- Make your changes following these best practices:

- Write clear, descriptive commit messages
- Follow the existing code style and conventions
- Add tests for new features
- Update documentation as needed
- Ensure all tests pass

Digi Remote Manager MCP allows users to connect Ai Agents to their Digi Remote Manager account for analyzing fleet data and help with troubleshooting.

Interact with Bigeye's data quality monitoring platform via its Datawatch API. Supports dynamic API key authentication.

Interact with the Flespi telematics platform API for fleet management, device tracking, and telemetry data processing.

A read-only API for querying and retrieving contextual information about devices and fleets using the Flight Control MCP server.

Enables LLMs and intelligent systems to interact with Litmus Edge for device configuration, monitoring, and management.

Interact with your TagoIO account to access devices, data, and platform resources for development and intelligent data analysis.

MCP server that exposes Ubidots IoT data, entities, and aggregations for AI assistants.

Allows easy local access to air-Q devices for retrieving air quality data

Blynk's MCP server lets AI coding tools create device templates, manage devices, and read live sensor data on the Blynk IoT platform

Live data-center, power & gas intelligence for AI agents

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cumulocity mcp server": {
            "cumulocity-mcp-server": {
                "command": "python",
                "args": [
                    "-m",
                    "mcp_server_c8y"
                ]
            }
        }
    }
}

McpServers

{
    "cumulocity-mcp-server": {
        "command": "python",
        "args": [
            "-m",
            "mcp_server_c8y"
        ]
    }
}

A Python-based server that provides Cumulocity IoT platform functionality through the MCP (Model Control Protocol) interface. This server enables seamless interaction with Cumulocity's device management, measurements, and alarm systems.

- List and filter devices
- Parameters:

- type: Filter by device type
- name: Filter by device name
- page_size: Results per page (max 2000)
- current_page: Page number

- Retrieve detailed information for a specific device
- Parameter:

- device_id: Device identifier

- View child devices of a specific device
- Parameter:

- device_id: Parent device identifier

- Access device fragments and their values
- Parameter:

- device_id: Device identifier

- Retrieve device measurements with time filtering
- Parameters:

- device_id: Device identifier
- date_from: Start date (ISO 8601 format)
- date_to: End date (ISO 8601 format)
- page_size: Number of measurements to retrieve

- Monitor active alarms in the system
- Parameters:

- severity: Filter by severity level
- page_size: Number of results to retrieve

evaluate_jsonata_expressionEvaluate a JSONata expression against a given JSON object.

Input: A JSON object as string and a JSONata expression string. Output: Result of the JSONata expression evaluation.

When usinguvno specific installation is needed for this package. We will use uvxto directly runmcp-server-c8y.

Alternatively you can installmcp-server-c8yvia pip:

After installation, you can run it as a script using:

You can deploy this server as a Cumulocity microservice for direct integration with your tenant. This is done by uploading a special deployment package (mcp-server-c8y.zip) to your Cumulocity tenant.

Building the Microservice Deployment Package

- Ensure you have Docker and zip installed on your system. - Run the provided build script to create the deployment package:

For more details on Cumulocity microservice deployment, see the official documentation.

This MCP Server can be used with Claude Desktop to enable Claude to interact with your Cumulocity IoT platform. Follow these steps to set it up:

Configure Claude Desktop to use this MCP Server:

- Open Claude Desktop
- Click on the Claude menu and select "Settings..."
- Navigate to "Developer" in the left-hand bar
- Click "Edit Config"

Add the following configuration to yourclaude_desktop_config.json:

"mcpServers": { "mcp-c8y": { "command": "uvx", "args": [ "mcp-server-c8y", "--transport", "stdio" ], "env": { "C8Y_BASEURL": "https://your-cumulocity-instance.com", "C8Y_TENANT": "your-tenant-id", "C8Y_USER": "<your-username>", "C8Y_PASSWORD": "<your-password>" } } }

Replace the following placeholders with your actual values:

You should now see a hammer icon in the bottom right corner of the input box. Click it to see the available Cumulocity tools.

For more detailed information about using MCP Servers with Claude Desktop, visit theofficial MCP documentation.

If you are using Cursor and have deployed your MCP Server to a Cumulocity tenant, you can configure your MCP server connection with a.cursor/mcp.jsonfile. Example (with sensitive data anonymized):

{ "mcpServers": { "Cumulocity": { "url": "https://your-cumulocity-instance.com/service/mcp-server-c8y/mcp/", "headers": { "Authorization": "Basic <YOUR_BASE64_AUTH_TOKEN>" } } } }