How do I install the Grab Merchant skill?

Run npx skillmds@latest add qhkm/grab-merchant in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Grab Merchant skill do?

Manage GrabFood/GrabMart orders, menus, and store hours via the Merchant API. It is listed under Integrations & APIs on SkillMD.

Is Grab Merchant safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Grab Merchant?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Grab Merchant free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Grab Merchant?

qhkm (@qhkm) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Grab Merchant by qhkm — Agent Skill

Name: Grab Merchant
Author: qhkm

File contents

Grab Merchant Skill

Manage GrabFood and GrabMart operations — orders, menus, and store availability.

Setup

Register at developer.grab.com
Create an app with food.partner_api scope
Get OAuth2 credentials

export GRAB_CLIENT_ID="your_client_id"
export GRAB_CLIENT_SECRET="your_client_secret"
export GRAB_MERCHANT_ID="your_merchant_id"

Get Access Token

export GRAB_ACCESS_TOKEN=$(curl -s -X POST "https://partner-api.grab.com/grabid/v1/oauth2/token" \
  -H "Content-Type: application/json" \
  -d "{
    \"client_id\": \"$GRAB_CLIENT_ID\",
    \"client_secret\": \"$GRAB_CLIENT_SECRET\",
    \"grant_type\": \"client_credentials\",
    \"scope\": \"food.partner_api\"
  }" | jq -r '.access_token')

List Recent Orders

curl -s "https://partner-api.grab.com/merchant/v2/orders?merchantID=$GRAB_MERCHANT_ID&limit=20" \
  -H "Authorization: Bearer $GRAB_ACCESS_TOKEN" \
  | jq '.orders[] | {id: .orderID, status, total: .price.totalPrice, items: [.items[].name]}'

Get Store Hours

curl -s "https://partner-api.grab.com/merchant/v2/store/hours?merchantID=$GRAB_MERCHANT_ID" \
  -H "Authorization: Bearer $GRAB_ACCESS_TOKEN" \
  | jq '.schedules[] | {day: .dayOfWeek, open: .openTime, close: .closeTime}'

Pause/Resume Store

curl -s -X POST "https://partner-api.grab.com/merchant/v2/store/pause" \
  -H "Authorization: Bearer $GRAB_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"merchantID\": \"$GRAB_MERCHANT_ID\", \"duration\": 60}" \
  | jq '.success'

Cancel an Order

ORDER_ID="order-id"
curl -s -X POST "https://partner-api.grab.com/merchant/v2/orders/cancel" \
  -H "Authorization: Bearer $GRAB_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"orderID\": \"$ORDER_ID\", \"merchantID\": \"$GRAB_MERCHANT_ID\", \"cancelCode\": 1001}" \
  | jq '.success'

Tips

OAuth2 access tokens expire in 1 hour — refresh using client_credentials flow
Cancel codes: 1001 (can't fulfill), 1002 (out of stock), 1003 (store closed)
API is region-scoped — base URL may vary by country
Rate limit depends on partnership tier
Custom MCP server planned for qhkm/zeptoclaw-sea repo

---name: grab-merchantdescription: Manage GrabFood/GrabMart orders, menus, and store hours via the Merchant API.license: MIT---# Grab Merchant SkillManage GrabFood and GrabMart operations — orders, menus, and store availability.## Setup1. Register at [developer.grab.com](https://developer.grab.com)2. Create an app with `food.partner_api` scope3. Get OAuth2 credentials```bashexport GRAB_CLIENT_ID="your_client_id"export GRAB_CLIENT_SECRET="your_client_secret"export GRAB_MERCHANT_ID="your_merchant_id"```## Get Access Token```bashexport GRAB_ACCESS_TOKEN=$(curl -s -X POST "https://partner-api.grab.com/grabid/v1/oauth2/token" \ -H "Content-Type: application/json" \ -d "{ \"client_id\": \"$GRAB_CLIENT_ID\", \"client_secret\": \"$GRAB_CLIENT_SECRET\", \"grant_type\": \"client_credentials\", \"scope\": \"food.partner_api\" }" | jq -r '.access_token')```## List Recent Orders```bashcurl -s "https://partner-api.grab.com/merchant/v2/orders?merchantID=$GRAB_MERCHANT_ID&limit=20" \ -H "Authorization: Bearer $GRAB_ACCESS_TOKEN" \ | jq '.orders[] | {id: .orderID, status, total: .price.totalPrice, items: [.items[].name]}'```## Get Store Hours```bashcurl -s "https://partner-api.grab.com/merchant/v2/store/hours?merchantID=$GRAB_MERCHANT_ID" \ -H "Authorization: Bearer $GRAB_ACCESS_TOKEN" \ | jq '.schedules[] | {day: .dayOfWeek, open: .openTime, close: .closeTime}'```## Pause/Resume Store```bashcurl -s -X POST "https://partner-api.grab.com/merchant/v2/store/pause" \ -H "Authorization: Bearer $GRAB_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d "{\"merchantID\": \"$GRAB_MERCHANT_ID\", \"duration\": 60}" \ | jq '.success'```## Cancel an Order```bashORDER_ID="order-id"curl -s -X POST "https://partner-api.grab.com/merchant/v2/orders/cancel" \ -H "Authorization: Bearer $GRAB_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d "{\"orderID\": \"$ORDER_ID\", \"merchantID\": \"$GRAB_MERCHANT_ID\", \"cancelCode\": 1001}" \ | jq '.success'```## Tips- OAuth2 access tokens expire in 1 hour — refresh using client_credentials flow- Cancel codes: 1001 (can't fulfill), 1002 (out of stock), 1003 (store closed)- API is region-scoped — base URL may vary by country- Rate limit depends on partnership tier- Custom MCP server planned for `qhkm/zeptoclaw-sea` repo

Frequently asked questions

Grab Merchant