dataforce

Dataforce MCP plugin

Query your Shopify orders, stock, and Google Ads from any MCP-speaking agent: Claude Code, Codex, Cursor, and anything else that talks the Model Context Protocol.

You ── "what were yesterday's top SKUs?" ──► Claude / Codex / Cursor
                                                      │
                                                      ▼
                                              Dataforce MCP server
                                              (Shopify + Ads + stock)

Login is OAuth. Click "Authorize Dataforce" once in your browser, and the agent remembers.

Install (Claude Code)

/plugin marketplace add Simplicity-Labs/dataforce-plugin
/plugin install dataforce@dataforce-plugin

That's it. First time you ask the agent something dataforce-y, it'll pop a browser tab for the OAuth flow.

Install (Codex, Cursor, others)

After the Claude Code install (or as a standalone), run the bundled setup skill:

/dataforce-setup

It detects which agents you have installed locally and writes the right MCP config to each:

Agent	Config file
Claude Code	handled by this plugin
Codex	~/.codex/config.toml
Cursor	~/.cursor/mcp.json
anything else	prints a copy-paste snippet

What you get

Tools exposed:

• get_orders — Shopify orders by date / SKU / channel
• get_stock_summary — inventory levels across locations
• query_ads — Google Ads campaigns, spend, ROAS
• cross_channel_summary — single report bridging orders + ad spend

How OAuth works

mcp-remote runs locally as a stdio bridge between your agent and the remote dataforce MCP server. On first use, it opens your browser to log in via Clerk and approve Dataforce. The resulting token sits in ~/.mcp-auth/ and refreshes automatically.

Your agent ── stdio ──► npx mcp-remote ── HTTPS ──► dataforce.simplicitylabs.io/api/mcp
                                │
                                └── browser-based OAuth on first run

Development

This repo IS the plugin. The MCP server itself lives in a separate (private) repo.

To work on the plugin:

git clone https://github.com/Simplicity-Labs/dataforce-plugin
cd dataforce-plugin
# edit .mcp.json, skills/, or .claude-plugin/plugin.json

To test locally without publishing:

/plugin marketplace add ~/path/to/dataforce-plugin
/plugin install dataforce

Links

• App: https://dataforce.simplicitylabs.io
• Docs: https://dataforce.simplicitylabs.io/docs
• Issues: https://github.com/Simplicity-Labs/dataforce-plugin/issues