SuperAuth

Simplest way to use authenticate enterprise apps and services like Google, Notion, Hubspot, Apollo, etc. 🚀

MCP server coming soon.

Quick Start

Install

Recommended:

The recommended method of installing SuperAuth is with pip from PyPI.

pip install superauth

Latest:

You can also install the latest bleeding edge version (could be unstable) of SuperAuth, should you feel motivated enough, as follows:

pip install git+https://github.com/celestoai/SuperAuth.git

Setup your API keys in the environment variables:

APOLLO_API_KEY=your_apollo_api_key

Apollo.io Example

Find contacts in your Apollo.io account by keywords.

from superauth.apollo_io import Apollo

apollo = Apollo()
response = apollo.contact.search("John Doe")
print(response)

Google API

Authenticate Gmail or Google Calendar to read, and send emails or send a calendar invite.

from superauth.google import GmailAPI, load_user_credentials

# Load your saved credentials
creds = load_user_credentials("credentials.my_google_account.json")

# Direct tool usage
gmail = GmailAPI(creds)
messages = gmail.search_messages(query="from:github.com", limit=10)

How to run tests

uv run pytest