Skip to content
littleworksdocs

Explore the documentation

Meet LittleworksA small backend for the Shopify task you and your agent are already working on.Connect your agentApprove access once, then return to the conversation where your task started.Build with an agentThe operating guide for an agent using Littleworks as part of an existing Shopify task.Write a workA JavaScript handler, a small manifest, and an immutable version each time you deploy.Store dataDocument collections with a small API, scoped automatically to the work that uses them.Call ShopifyUse Shopify’s GraphQL API directly, with credentials held by Littleworks.Expose an endpointConnect an existing frontend to a work through a small JSON API.MCP tool referenceTen tools to inspect, deploy, run, and manage the backend for a connected store.Inspect and troubleshootFind the relevant run, understand the failure, and make the next change deliberately.Limits and securityThe current runtime boundaries, data isolation model, and execution allowances.
Shopify admin
Browse documentation
Start here
Markdown

Connect your agent

Approve access once, then return to the conversation where your task started.

1. Open Littleworks in Shopify

Open Shopify admin, select your store, and open Apps → Littleworks. A new installation shows connection instructions on the Works page. If you have already finished setup, open Agent access.

2. Share the connection instructions

Copy the instructions from Littleworks and paste them into your existing agent conversation. They contain the remote MCP URL for your store and the steps for your selected coding agent. Keep your existing MCP connections when adding Littleworks.

If your agent application has a remote MCP connection form, use the server URL shown in Littleworks and its OAuth authorization flow. Available settings depend on the client. Guided ChatGPT and Claude connection screens are not yet part of Littleworks.

3. Approve access in Shopify

Your agent opens an authorization link. Littleworks shows the requesting client, its callback address, the store, and the access requested. Review those details and approve the connection inside Shopify.

A connection lets the agent manage works, invoke them, read stored records, and inspect runs in both Preview and Live. Works can call Shopify only through the app’s approved permissions. Your Shopify credentials are not given to the agent.

4. Return to your agent

Have the agent call get_context, then list_functions. These confirm the connection and show what already exists. If the client needs a new session to load tools, follow its instructions and carry your task into that session.

When Littleworks confirms the connection, choose Finish setup if it is shown. Continue your original task with your agent. Works appear in Shopify admin as the agent deploys them.

Manage or disconnect an agent

Use Agent access to review active connections or disconnect one. Disconnecting prevents future agent requests; deployed works continue running. Pause a work separately if you want its execution to stop.

If tools do not appear or authorization fails, see Troubleshooting.