Get Started withGraphQL Grab
The missing GraphQL DevTool. Capture any GraphQL API in one command.
Installation
Install GraphQL Grab globally using your preferred package manager:
npm install -g graphql-grabyarn global add graphql-grabpnpm add -g graphql-grabVerify the installation:
gqlgrab --versionAuthentication & License
GraphQL Grab offers a free tier with basic features. Unlock Pro features like unlimited captures and all export formats with a license.
Get Your License Key
Open the browser to get your license key:
gqlgrab auth loginThis opens the web dashboard where you can sign up or log in.
Activate Your License
Copy your license key from the dashboard and activate it:
gqlgrab auth activate <your-license-key>Check License Status
View your current license status and usage:
gqlgrab auth statusOffline Mode
Your license is cached locally with a 7-day grace period. Continue using Pro features offline for up to 7 days before re-validation is required.
Quick Start
Start the proxy server
gqlgrab capture --port 8080This starts a local proxy server on port 8080 that captures all GraphQL requests.
Configure your application
Point your application or browser to use the proxy:
export HTTP_PROXY=http://localhost:8080Make requests
Use your application normally. GraphQL Grab automatically detects and captures GraphQL requests.
Export the session
gqlgrab export session.json --format postmanExport captured requests to Postman, Insomnia, cURL, or HAR format.
HAR File Import
Already have network traffic captured? GraphQL Grab can analyze HAR files exported from browser DevTools or other network capture tools.
Export HAR from Chrome DevTools
- Open Chrome DevTools (F12 or Cmd+Opt+I)
- Go to the Network tab
- Perform your GraphQL operations
- Right-click in the Network panel and select "Save all as HAR with content"
Analyze the HAR File
gqlgrab analyze network.harView statistics and summary of all GraphQL operations.
Search for Specific Operations
gqlgrab search network.har 'UserQuery'Find specific queries or mutations by name.
Export to Other Formats
# Export to cURL commands
gqlgrab export network.har --format curl
# Export to Postman collection (Pro)
gqlgrab export network.har --format postman --output collection.json
# Export to Insomnia (Pro)
gqlgrab export network.har --format insomnia --output workspace.jsonCommands Reference
captureStart a proxy server and capture GraphQL requests
Usage
gqlgrab capture [options]Options
--port, -pPort to run the proxy on (default: 8080)--output, -oOutput file for session data (default: session.json)--filterFilter requests by URL patternExample
gqlgrab capture --port 3000 --output my-session.jsonanalyzeAnalyze a captured session or HAR file
Usage
gqlgrab analyze <file>Options
--statsShow detailed statistics--queriesList all unique queries--mutationsList all unique mutationsExample
gqlgrab analyze session.json --statsexportExport session to various formats
Usage
gqlgrab export <file> [options]Options
--format, -fExport format: curl (free), postman, insomnia, har (Pro)--output, -oOutput file path--filterFilter operations by name patternExample
gqlgrab export session.json --format postman --output collection.jsonsearchSearch for operations in a session
Usage
gqlgrab search <file> <query>Options
--regex, -rUse regex pattern for search--field, -fSearch in specific field: name, query, variablesExample
gqlgrab search session.json 'user' --regexlistList all operations in a session
Usage
gqlgrab list <file> [options]Options
--type, -tFilter by type: query, mutation, subscription--verbose, -vShow detailed informationExample
gqlgrab list session.json --type queryauthManage license and authentication
Usage
gqlgrab auth <command>Options
loginOpen browser to get license keyactivate <key>Activate a license keystatusShow current license statuslogoutDeactivate license and log outExample
gqlgrab auth activate gql_xxxx...Proxy Setup
Browser Configuration
Configure your browser to use the GraphQL Grab proxy:
CChrome / Edge
- Open Settings → System → Open proxy settings
- Set HTTP proxy to localhost:8080
- Apply settings
FFirefox
- Open Settings → Network Settings
- Select Manual proxy configuration
- Set HTTP Proxy to localhost, Port to 8080
- Click OK
System-Wide Proxy (macOS/Linux)
export HTTP_PROXY=http://localhost:8080
export HTTPS_PROXY=http://localhost:8080System-Wide Proxy (Windows)
set HTTP_PROXY=http://localhost:8080
set HTTPS_PROXY=http://localhost:8080Free vs Pro
Free Tier
- Up to 100 requests per capture
- 1 saved session
- cURL export format
- HAR file analysis
- Search and filter operations
Pro
$12/month- Unlimited requests per capture
- Unlimited saved sessions
- All export formats (Postman, Insomnia, HAR, cURL)
- 7-day offline grace period
- Priority support