Metadata-Version: 2.3
Name: superauth
Version: 0.0.1
Summary: APIs and MCP Server for Enterprise Apps like Google, Notion, Hubspot...
Author: Aniket Maurya
Author-email: Aniket Maurya <aniket@celesto.ai>
Requires-Dist: backoff>=2.2.1
Requires-Dist: dotenv>=0.9.9
Requires-Dist: google-api-python-client>=2.184.0
Requires-Dist: google-auth>=2.41.1
Requires-Dist: google-auth-httplib2>=0.2.0
Requires-Dist: google-auth-oauthlib>=1.2.2
Requires-Dist: httpx>=0.28.1
Requires-Dist: pydantic>=2.11.9
Requires-Dist: pydantic-settings>=2.10.1
Requires-Dist: requests>=2.32.5
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# SuperAuth 🐜

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

MCP server coming soon.

## Quick Start

### Install

Install the latest version:

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

Setup your API keys in the environment variables:

```bash
APOLLO_API_KEY=your_apollo_api_key
```


### Apollo.io Example

Find contacts in your Apollo.io account by keywords.

```python
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.

```python
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`
