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.7.10.tar.gz (104.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.7.10-py3-none-any.whl (135.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: myeliza_cli-1.7.10.tar.gz
  • Upload date:
  • Size: 104.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","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.7.10.tar.gz
Algorithm Hash digest
SHA256 43a026c58480ef1b6c5ea92ea68c48ca1956f2356928d7c1e9166046d3a9c063
MD5 5045fbfda0f4dd56815b15f8bae6091b
BLAKE2b-256 ec9b370500b30b91f59e9809333ff34e271fb6fe4071d6ee53cb9aa96d24b19a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: myeliza_cli-1.7.10-py3-none-any.whl
  • Upload date:
  • Size: 135.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","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.7.10-py3-none-any.whl
Algorithm Hash digest
SHA256 03f820b24b0f3f4d472d2d4c78a54c77e5892d2cc302180995e802c075b275a5
MD5 6ae36a7d809d177ca6784acf6944981d
BLAKE2b-256 7b83f6384b8bc391917d0ada8d1b7b24d039e7588c19f27c3717c79fc4f7e197

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