Structured CLI

Browser-backed CLI and MCP adapter for https://web.structured.app/.

This project wraps the closed-source Structured web app with:

• a CLI: cli-anything-structured
• a local stdio MCP server: structured-mcp

The harness reads Structured data from the app's own browser-side stores and drives mutations through verified UI flows instead of direct local database writes.

Quick Start

Install the package in editable mode:

pip install -e .

Log into Structured once with the CLI:

cli-anything-structured session login

Then either use the CLI:

cli-anything-structured session status
cli-anything-structured task list --location all
cli-anything-structured recurring list --frequency weekly

Or start the local MCP server:

structured-mcp

Repository Layout

structured-cli/
├── README.md                              # repo entrypoint
├── STRUCTURED.md                          # backend notes and guardrails
├── setup.py                               # package metadata + console entry points
└── cli_anything/structured/
    ├── README.md                          # user-facing CLI and MCP usage
    ├── structured_cli.py                  # Click CLI
    ├── mcp_server.py                      # local stdio MCP server
    ├── core/
    │   └── models.py                      # shared dataclasses
    ├── utils/
    │   └── agent_browser_backend.py       # browser-backed Structured adapter
    ├── tests/
    │   ├── TEST.md                        # test scope and manual verification notes
    │   ├── test_backend.py                # backend unit tests
    │   ├── test_cli.py                    # CLI tests
    │   └── test_mcp_server.py             # MCP surface tests
    └── skills/
        └── SKILL.md                       # skill metadata for agent workflows

Documentation

• Harness Notes
• CLI and MCP Usage
• Test Notes

License

MIT. See LICENSE.

Validation

Typical local checks:

python3 -m unittest cli_anything/structured/tests/test_backend.py -v
python3 -m unittest cli_anything/structured/tests/test_cli.py -v
python3 -m unittest cli_anything/structured/tests/test_mcp_server.py -v