celeryhq Simplified CLI (smp) — Module Index
smp is the unified CLI for the Simplified API, distributed as the
simplified-apikit pip/pipx package. It exposes 4 functional modules plus an
MCP server, all auto-generated from OpenAPI specs.
Installation
pipx install simplified-apikit \
--index-url "https://gitlab.com/api/v4/projects/70495826/packages/pypi/simple" \
--pip-args="--extra-index-url https://pypi.org/simple"
Authentication
Auth is read from environment variables — set once, use everywhere:
export SMP_TOKEN=your_api_token # API key (sQL00kSs.xxx) or DRF token
export SMP_WORKSPACE=270 # required for DRF tokens; inferred for API keys
export SMP_SPACE=42 # optional, for space-scoped resources
export SMP_URL=https://api.simplified.com # default; omit for prod
Or pass per-call: smp --token xxx --workspace 270 pm list-boards
Command Syntax
Subcommands use space separation: smp pm list-boards. The legacy colon form
(smp pm:list-boards) also works for back-compat.
Modules
The CLI is organised by module. Pick the right one for the task:
smp pm — Project Manager
Boards, statuses, tasks, subtasks, assignees, tags, dependencies, comments, activity. The most stateful module — has a memory-cache discipline for board/status/user IDs.
→ See references/pm.md for full guide.
smp pm list-boards
smp pm create-task --status <uuid> --title "Fix login" --assignees '[196]'
smp pm search-tasks --board <id> --status <id> --search "login"
smp pm add-task-dependency --task-id <a> --target-task-id <b> --relation-type BLOCKS
smp media — Image & Video AI Tools
Background removal, upscaling, generative fill, outpainting, inpainting, format conversion, video merging, B-roll, text/script to video. Mostly async — middleware auto-polls for results.
→ See references/media.md for full guide.
smp media remove-background --image-url "https://..."
smp media upscale-image --image-url "https://..." --scale 4
smp media merge-videos --video-urls '["https://a.mp4","https://b.mp4"]'
smp media text-to-video --payload '{"title":"Sunset timelapse","tone":"calm"}'
smp api — Assets API
Workspaces, brand kits (V2), projects and project items, AI image generation, assets, context documents, brand books, agents.
→ See references/api.md for full guide.
smp api get-workspace
smp api list-brand-kits
smp api generate-image --prompt "sunset over mountains"
smp api create-project --primary-type ASSET --title "Q1 launch"
smp social — Social Media
Connected accounts, posts (publish/draft/schedule), tags, and analytics (range, posts, aggregated, audience).
→ See references/social.md for full guide.
smp social get-social-media-accounts
smp social create-social-media-post --payload '{"caption":"Hello","accounts":[...]}'
smp social get-social-media-analytics-aggregated --account-id <id>
smp comments — Comments
Threaded comments on any commentable Simplified resource. Currently supports
tasks; will grow to other types. Generic by design — addressed by
content_type + object_pk rather than a resource-specific shortcut.
→ See references/comments.md for full guide.
smp comments list-comments --content-type task --object-pk <task_uuid>
smp comments add-comment --content-type task --object-pk <task_uuid> --comment "LGTM"
smp serve — MCP Server
Exposes every module command above as an MCP tool. Use from Claude Desktop, Cursor, Cline, or any MCP host.
smp serve # stdio (default — for Claude Desktop/Cursor)
smp serve --transport http --port 9000 # HTTP transport
The middleware handles pre/post hooks (e.g. inline assignees on pm create-task,
auto Quill-Delta description conversion), response normalization, and async task
polling — so MCP clients get the same ergonomic interface as the CLI.
Discovering Commands
Don't rely on a static table. The CLI is auto-generated from OpenAPI specs and
--help is always current:
smp --help # list modules
smp pm --help # list pm commands
smp pm create-task --help # full options for a single command
Output
By default smp pretty-prints JSON. Pass --raw for unformatted output (useful
when piping into jq / python3 -c):
smp --raw pm list-boards | jq '.results[].id'
Cross-cutting Patterns
Async tasks. Several endpoints (media/*, api generate-image, some video ops)
return a task_id. The middleware polls GET /api/v1/tasks/{task_id} automatically
and returns the final result. Default polling is ~3.75 min — video generation may
need longer. If it times out you'll get the task_id to poll manually.
Composite fields. pm create-task / pm update-task accept assignees and tags
inline; the toolkit makes follow-up sub-resource calls automatically.
JSON args. Array/object options need single quotes around JSON:
--assignees '[196, 200]', --payload '{"title":"..."}'.
Pagination. List endpoints default to page_size=10. Add --page-size 100 to
get more.