Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

grpcurl

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • Self-hosted
7.7 Club score Visit github.com

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

grpcurl

Free

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.