Get Started withGraphQL Grab
The missing GraphQL DevTool. Capture any GraphQL API in one command. 100% free, no account required.
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 --versionQuick 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
gqlgrab export network.har --format postman --output collection.json
# Export to Insomnia
gqlgrab export network.har --format insomnia --output workspace.json
# Export all formats at once
gqlgrab export network.har --format curl,postman,insomnia,harCommands 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)--httpsEnable HTTPS proxy mode--introspectAuto-fetch schemas from detected endpointsExample
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, postman, insomnia, har (all free!)--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--type, -tFilter by type: query, mutation, subscriptionExample
gqlgrab search session.json 'user' --type querylistList 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 queryintrospectFetch GraphQL schema from an endpoint
Usage
gqlgrab introspect <url> [options]Options
--output, -oOutput file path for schema--headers, -HCustom headers (key:value format)Example
gqlgrab introspect https://api.example.com/graphql --output schema.graphqlProxy 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:8080All Features - 100% Free
Everything Included
No limits, no paywalls, no account required
- Unlimited request captures
- Unlimited saved sessions
- All export formats (cURL, Postman, Insomnia, HAR)
- HAR file analysis
- Schema introspection
- Search and filter operations
- TypeScript code generation
- Works offline - no internet required