The Connector Builder Hub is the visual, browser-based way to create and manage connectors – complete with its own AI assistant – and for most people it's the best place to start. But if you prefer to work from your terminal, automate your workflow, or build connectors from your own code, you can use developer tools instead.
This page gives a high-level overview of the available options and points you to the right documentation and repositories for each. It intentionally stays brief – follow the links for setup steps and detailed usage.
Ways to build a connector
| Option | Best for | Where to go |
|---|---|---|
| Connector Builder Hub (UI) | Building and managing connectors visually in the browser – no local setup required. | Connector Builder documentation |
| Supermetrics CLI | Developers who want to build, validate, and test connectors from the terminal or integrate them into scripts and pipelines. | CLI documentation · GitHub |
| Connector Builder plugin (Claude Code) | An AI-guided, terminal-based workflow that walks you through building a connector step by step using Claude Code. | GitHub |
| Supermetrics API | Building and managing connectors programmatically over HTTP, for example from your own applications or automation. | API documentation |
| Python SDK | Building and managing connectors from Python code with a typed, official client. | SDK documentation · GitHub |
Supermetrics CLI
The Supermetrics CLI brings Connector Builder to your terminal. In addition to querying data and managing authentication, it lets you develop custom connectors – validating configurations, checking schemas, and running queries – without leaving the command line. This makes it a good fit if you want to keep connector development close to your code, or integrate it into automation, scheduled jobs, and deployment pipelines.
- Documentation: docs.supermetrics.com/apidocs/cli
- Repository: github.com/supermetrics-public/supermetrics-cli
Note: The CLI is currently in alpha, so its features are still evolving.
Connector Builder plugin for Claude Code
The Connector Builder plugin is a plugin for Claude Code that layers an AI-guided workflow on top of the Supermetrics CLI. Instead of writing the connector configuration by hand, you're guided through a structured process – scoping the data source, documenting endpoints and authentication, verifying requests, writing the configuration, and validating the output – all from your terminal.
It's a good option if you'd like assistance turning an API into a working connector while staying in a code-first environment.
Because the plugin runs on top of the Supermetrics CLI, you'll need the CLI installed before using it. See the plugin repository for setup details.
Supermetrics API
If you'd rather work directly over HTTP, the Supermetrics API lets you build and manage connectors programmatically. The Connector Builder endpoints are available under Management API reference → Connector Builder in the API documentation. This is a good fit when you want to create or update connectors from your own applications, tooling, or automated workflows.
- Documentation: docs.supermetrics.com/apidocs
Python SDK
The Python SDK is the official Python client for the Supermetrics API. It wraps the same Connector Builder capabilities in a typed, Pythonic interface, so you can build and manage connectors – as well as query data and handle authentication – directly from your Python code.
- Documentation: docs.supermetrics.com/apidocs/python-sdk
- Repository: github.com/supermetrics-public/supermetrics-python-sdk
Which should you choose?
- Start with the Hub UI if you want the most guided, visual experience.
- Use the CLI if you prefer working in the terminal or need to script and automate connector development.
- Try the Connector Builder plugin for Claude Code if you'd like AI-assisted connector building from your terminal.
- Reach for the API or Python SDK when you want to build and manage connectors programmatically from your own code.