Elemctl

An unofficial CLI, MCP server and Python library for the 1C:Enterprise.Element Console API: apps, builds and deploys with apply verification

CLIHigh riskRussian stack

keyfire/elemctl

Install

pipx install elemctl

CLI only, no external dependencies.

This is third-party code. Review the repository files before installing.

What it does

The tool manages applications in the 1C:Enterprise.Element cloud without the web console. It creates, starts, stops and deletes apps, builds a .xasm or .xlib archive from project sources, uploads the build and applies it. After a deploy elemctl verifies the build really applied by checking task errors, the app's project version and whether its URL responds, because the platform can roll back silently. The probe command checks compilation in a throwaway app without touching the working one. The same operations are exposed to agents through an MCP server, and JSON CLI output suits CI.

Who it is for. For 1C:Enterprise.Element developers who want to deploy from a terminal, CI or an agent.

Good fit when

  • You want to build and deploy an Element app in one command
  • You want the agent to check compilation without breaking the working app
  • You need CI deploys with a reliable exit code

Not a fit when

  • You develop on 1C:Enterprise 8 rather than Element
  • The agent must not be able to delete cloud apps

Example request

Run a probe compile of the current project and, if there are no errors, deploy it to the app

Limitations

The project is unofficial and uses only the documented Console API v2. It needs Client-Id and Client-Secret from the Console API integrations section of the 1cmycloud panel. Python 3.10 is required, and the MCP server needs the mcp extra. On some platform setups an app created from a project ID alone comes out empty; the author documents a workaround.

How to disable. Remove the server with claude mcp remove elemctl and uninstall with pipx uninstall elemctl or pip uninstall elemctl. Revoke the keys in the 1cmycloud panel.

Security check

  • Deploys builds, restarts and deletes apps in the 1C:Enterprise.Element cloud
  • Stores a Console API secret

README in short

The English and Russian README covers apps, builds from sources, verified deploys, probe, user lists, dev environment branches and dumps. Installation is via pipx or pip, configuration via environment variables or .env, with notes on private cloud certificates and CI variables. It has sections on the MCP server and a plugin system where one command becomes both a CLI subcommand and an MCP tool. MIT licensed.

FAQ

Why verify a deploy if the status is Running?

When an apply fails the platform silently rolls back to the previous build without changing status. elemctl checks the project version and task errors, and the exit code is zero only if the build applied.

Does probe touch the working app?

No, it compiles in a throwaway app that is deleted afterwards. probe deliberately ignores ELEMENT_APP_ID and ELEMENT_PROJECT_ID.

Editors’ pick

An MCP server built into the Netdata agent: metrics, logs, alerts and live process, service and container data for an AI assistant

MCP serverMedium risk80.5K
Editors’ pick

GitHub's official MCP server: code, issues, pull requests, Actions and security alerts straight from the agent

MCP serverHigh risk32.9K
Editors’ pick

A GitHub Action that runs Claude Code in pull requests and issues: answers mentions, reviews and makes changes

PluginHigh risk8.9K
Editors’ pick

An AI assistant for Kubernetes that turns plain-language requests into kubectl operations and doubles as an MCP server

CLIHigh risk7.6K