grpcurl
github.com
- Free plan
- Windows
- macOS
- Linux
- Self-hosted
What grpcurl is
grpcurl is a free command-line utility for calling methods on gRPC servers. It accepts request data as JSON and converts it to protobuf binary messages, making terminal use and scripting straightforward. Its list and describe commands expose services, methods, and schema details. grpcurl can discover schemas through server reflection, .proto source files, or compiled protoset files. If reflection is unavailable, one of those files is required to understand the service schema. Streaming RPCs are supported, including interactive bidirectional sessions using a terminal and stdin. Connections can use TLS or plaintext, with TLS settings and mutual TLS client certificates available. The project runs on Linux, macOS, and Windows, and supports self-hosted use. Installation options documented by the project include release binaries, Homebrew, Docker, Snap, source builds, and third-party packages. A Go library package is provided for building tools that dynamically invoke gRPC endpoints. The repository identifies the license as MIT. No paid plans or usage limits are stated.
Who it suits
grpcurl suits developers and operators who need to inspect or invoke gRPC services from a command line. It also fits scripts and pipelines that can provide JSON requests and schema files when needed.
Good to know, and what to watch
- Free command-line gRPC access
- JSON request support
- Schema inspection commands
- Streaming RPC support
- TLS and mutual TLS options
- Requires schema files without reflection
- No graphical interface listed
- No GraphQL or WebSocket support
Plans
Every plan and pricegrpcurl
Free plan
The verdict
grpcurl provides a focused terminal workflow for exploring and calling gRPC services. Its JSON input, schema discovery, streaming, and TLS options cover interactive use and automation without a paid plan.
What the maker publishes
- API documentation
- No source
- Automated test runs
- No source
- Free plan
- Yes source
- GraphQL support
- No source
- gRPC support
- Yes source
- Inspection
- Its list and describe commands can show services, methods, and schema descriptions. source
- Installation
- The README documents release binaries, Homebrew, Docker, Snap, installation from source, and third-party packages. source
- Integrations
- The project provides a Go library package for building command-line tools that dynamically invoke gRPC endpoints. source
- JSON requests
- It accepts request messages as JSON and translates them to protobuf binary format. source
- License
- The repository identifies its license as MIT. source
- Available platforms
- desktop source
- Platforms
- The README mentions macOS Homebrew and third-party packages for Windows and Linux distributions. source
- Purpose
- grpcurl is a command-line tool for interacting with gRPC servers and invoking RPC methods. source
- Schema discovery
- It can browse service schemas using server reflection, .proto source files, or compiled protoset files. source
- Schema requirement
- If a server lacks reflection, grpcurl requires the service's proto source files or protoset files to understand its schema. source
- Streaming
- It supports streaming RPCs, including interactive bidirectional streaming through a terminal and stdin. source
- Team workspaces
- No source
- TLS
- It supports TLS, plaintext connections, TLS configuration options, and mutual TLS client certificates. source
- Use case
- The project describes JSON input as useful for people and scripts and gives an example of using grpcurl in a command pipeline. source
- WebSocket support
- No source
Checked against the maker's pages on 5 Oct 2026.