Skip to main content

Command-line interface and MCP server for the ELIZA platform

Project description

ELIZA CLI

Command-line interface for the ELIZA platform — for humans and AI agents.

New here? Check out the Quick Start Guide.

Installation

# From PyPI
pip install myeliza-cli

# Or with uv
uv tool install myeliza-cli

# Or from source
git clone https://gitlab.com/eliza.swiss/myeliza-cli.git
cd myeliza-cli && uv sync

Quick Start

# Configure an instance
myeliza auth login --instance elizaag --url https://eliza.myeliza.ch/api --token YOUR_TOKEN --default

# Check connection
myeliza auth status

# List support tickets
myeliza issues list --tracker 2 --limit 10

# Get issue details
myeliza issues get 2530

# Add a followup
myeliza issues followup-add 2530 --comment "Fix deployed"

# List users
myeliza users list

# Add work time
myeliza time add --user 2 --date 2026-03-10 --start 08:00 --end 12:00

# List news streams
myeliza streams list

# Post a message to a stream
myeliza streams messages create --stream 1 --title "Update" --text "Deployed v2.0"

# List KPIs
myeliza kpi list

# Record a KPI measurement
myeliza kpi record 550e8400-e29b-41d4-a716-446655440000 --date 2026-03-10 --value 42

Output Formats

myeliza issues list -t 2 -l 5              # Rich table (default)
myeliza issues list -t 2 -l 5 -f json      # JSON (for scripting/agents)
myeliza issues list -t 2 -l 5 -f csv       # CSV

Dry Run

# Show the HTTP request without executing it
myeliza --dry-run issues list --tracker 2

Configuration

Config is stored in ~/.myeliza/config.yaml:

default: elizaag
instances:
  elizaag:
    url: https://eliza.myeliza.ch/api
    token: your-token-here
  iks2:
    url: https://iks2.myeliza.ch/api
    token: your-token-here

Environment Variables (backward compatible)

export ELIZA_ELIZAAG_URL=https://eliza.myeliza.ch/api
export ELIZA_ELIZAAG_TOKEN=your-token
export ELIZA_DEFAULT=elizaag

AI Agent Integration

Bundled Skills (API Documentation)

The package includes 24 skill modules with detailed API documentation, examples and scripts. AI agents can discover them automatically:

# Find the skills directory
myeliza skills-path
# → /home/user/.local/lib/python3.12/site-packages/myeliza_cli/skills/

# Each skill contains a SKILL.md with:
# - API endpoints and fields
# - CLI examples
# - Python scripts for common tasks

Agent workflow:

  1. pip install myeliza-cli — install the package
  2. myeliza auth login ... — configure an ELIZA instance
  3. myeliza skills-path — find the skill documentation
  4. Read the relevant SKILL.md files — understand the API
  5. Use myeliza commands or MCP tools — interact with ELIZA

MCP Server (Model Context Protocol)

The CLI includes a built-in Model Context Protocol server, allowing AI agents to interact with ELIZA directly.

With Claude Code

# Register ELIZA as MCP tool provider
claude mcp add myeliza -- myeliza mcp serve

# Now Claude Code can use ELIZA tools natively:
# "List the latest support tickets" → calls eliza_issues_list
# "Create an issue in tracker 2" → calls eliza_issues_create

With OpenClaw

Add to your OpenClaw config (openclaw.json):

{
  "mcp": {
    "servers": {
      "myeliza": {
        "command": "myeliza",
        "args": ["mcp", "serve"]
      }
    }
  }
}

Available MCP Tools (33)

Tool Description
eliza_trackers_list List all trackers (Meldekreise)
eliza_issues_list List issues with optional filters (tracker, state, limit)
eliza_issues_get Get issue details by ID
eliza_issues_create Create a new issue
eliza_issues_update Update issue (state, title, assignment)
eliza_issues_followups List followups for an issue
eliza_issues_followup_add Add a followup comment
eliza_dms_documents List documents (optional folder, type filter)
eliza_dms_document_get Get document details by ID
eliza_dms_folders List DMS folders
eliza_dms_doctypes List document types
eliza_users_list List users
eliza_users_get Get user details
eliza_time_list List work time entries
eliza_time_add Add a work time entry
eliza_streams_list List streams (Newskanäle)
eliza_streams_messages_list List stream messages (optional stream filter)
eliza_streams_messages_create Create a message in a stream
eliza_kpi_list List KPIs (optional folder filter)
eliza_kpi_record Record a KPI measurement
eliza_processes_list List processes (filter by state, search)
eliza_processes_get Get process details by ID
eliza_processes_create Create a new process
eliza_forms_list List form templates (optional folder filter)
eliza_forms_get Get full template with sections and questions
eliza_spaces_list List spaces (filter by state, search)
eliza_spaces_get Get space details by ID
eliza_spaces_card_create Create a card in a board card list
eliza_spaces_meeting_create Create a meeting in a space
eliza_spaces_meetingitems List meeting items (Traktanden)
eliza_spaces_meetingitem_create Create a meeting item
eliza_standards_list List standards (optional category filter)
eliza_standards_get Get standard details by ID

All MCP responses are compact JSON optimized for LLM consumption — HTML stripped, base64 images removed, nested objects flattened.

Testing the MCP Server

# Start server manually (stdio)
myeliza mcp serve

# Test tools programmatically
python3 -c "
import asyncio
from myeliza_cli.mcp_server import call_tool
result = asyncio.run(call_tool('eliza_trackers_list', {}))
print(result[0].text)
"

Commands

Command Status Description
myeliza auth Authentication & instance management
myeliza issues Issues / Meldungen (CRUD + followups + trackers)
myeliza users Users & groups
myeliza time Time tracking & absences
myeliza mcp MCP server for AI agents
myeliza dms Document management
myeliza streams News streams & events
myeliza kpi KPIs / Kennzahlen
myeliza processes Process management (CRUD + steps + transitions)
myeliza spaces Spaces (boards, cards, comments, meetings)
myeliza forms Forms (templates, sections, questions)
myeliza standards Standards / Normen (categories, chapters)
myeliza glossar Glossary (CRUD)
myeliza organisation Employees, org units, functions, memberships
myeliza contracts Contracts, partners, cashflows
myeliza projects Projects, tasks, milestones, phases
myeliza tutorials E-learning courses, lessons, sections
myeliza okr OKR (objectives, key results, updates)
myeliza swot SWOT / risk management (measures, controls)
myeliza dsg Data protection (activities, TOMs, categories)
myeliza bot AI chat conversations
myeliza measuring Measuring tools / calibration tracking
myeliza resources Resource inventory & allocations
myeliza businesscontext Stakeholders & business context
myeliza ims Integrated management system (assets)

Architecture

src/myeliza_cli/
├── main.py          # Typer app with subcommand groups + --dry-run
├── client.py        # REST API client (auto-pagination, multi-instance, dry-run)
├── config.py        # Config management (~/.myeliza/config.yaml + env vars)
├── output.py        # Formatters (Rich table, JSON, CSV)
├── mcp_server.py           # MCP server (stdio transport, 33 tools)
└── commands/
    ├── auth.py              # login, logout, status, instances
    ├── issues.py            # list, get, create, update, followups, trackers
    ├── users.py             # list, get, groups
    ├── time.py              # list, add, absences
    ├── dms.py               # documents, folders, document types
    ├── streams.py           # streams, messages, events
    ├── kpi.py               # KPIs, folders, measurements
    ├── processes.py         # processes, steps, labels, transitions
    ├── forms.py             # templates, folders, sections, questions
    ├── spaces.py            # spaces, boards, cards, comments, meetings
    ├── standards.py         # standards, categories, chapters
    ├── glossar.py           # glossary entries
    ├── organisation.py      # employees, org units, functions
    ├── contracts.py         # contracts, partners, cashflows
    ├── projects.py          # projects, tasks, milestones, phases
    ├── tutorials.py         # e-learning courses, lessons
    ├── okr.py               # objectives & key results
    ├── swot.py              # SWOT measures, estimates, controls
    ├── dsg.py               # data protection (DSG/GDPR)
    ├── bot.py               # AI chat conversations
    ├── measuring.py         # measuring tools, calibration
    ├── resources.py         # resource inventory, allocations
    ├── businesscontext.py   # stakeholders, context issues
    └── ims.py               # integrated management system

License

MIT — ELIZA AG

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

myeliza_cli-1.4.7.tar.gz (77.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

myeliza_cli-1.4.7-py3-none-any.whl (110.5 kB view details)

Uploaded Python 3

File details

Details for the file myeliza_cli-1.4.7.tar.gz.

File metadata

  • Download URL: myeliza_cli-1.4.7.tar.gz
  • Upload date:
  • Size: 77.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for myeliza_cli-1.4.7.tar.gz
Algorithm Hash digest
SHA256 92cb9054ce52afadb6234b2c974f928e48e1c9343bbe0f052b06cf763224b330
MD5 7c7a33b75d5d6f130b97ba35d8952ef5
BLAKE2b-256 3a19749644f19b11b8fe905f9123dbe6ca14853e3a8b6d95cd7b01e60eb272dc

See more details on using hashes here.

File details

Details for the file myeliza_cli-1.4.7-py3-none-any.whl.

File metadata

  • Download URL: myeliza_cli-1.4.7-py3-none-any.whl
  • Upload date:
  • Size: 110.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for myeliza_cli-1.4.7-py3-none-any.whl
Algorithm Hash digest
SHA256 78acae4f99b8401567fb32b4fa6df1c80abeda270c131bfa28a3ea7babe93759
MD5 42537d26cc693dc983b39fff309f7779
BLAKE2b-256 398ed116d3a73626e66a74d7c936a556adb09cf41049114de7078924d1df903a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page