Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
manojbajaj95 avatar

Authsome

  • 2.9k installs
  • 75 repo stars
  • Updated July 24, 2026
  • manojbajaj95/authsome

authsome is an agent skill that routes outbound HTTPS through a credential-injecting gateway so agents call Gmail, GitHub, Stripe, and other APIs without handling secrets directly.

About

authsome lets agents access external services such as Gmail, GitHub, and Stripe by prefixing commands with authsome run so outbound HTTPS traffic passes through a gateway that injects stored credentials as headers. Standard clients including curl, fetch, requests, axios, Go net/http, and git honor HTTPS_PROXY automatically, so agents should not set auth headers manually. The login flow requires the agent to run authsome login provider, poll authsome provider list, and show authentication URLs if the browser OAuth is still pending. Failure handling starts with authsome provider list, then login, revoke, or re-login with --scopes for 401 and 403 responses, and provider registration only when the provider is missing. Installation uses uv tool install authsome with pipx or uvx fallbacks. Rules forbid claiming no access without trying the proxy, forbid manual API key collection from users, and require reading authsome --help before guessing command syntax.

  • Wrap commands with authsome run so the gateway injects OAuth and API key credentials via HTTPS_PROXY.
  • Supports Gmail, GitHub, Google Calendar, Google Drive, Stripe, and other connected providers.
  • Login flow uses authsome login with provider list polling instead of manual token entry.
  • 401 and 403 troubleshooting uses revoke, scoped re-login, or provider registration decision tree.
  • Install via uv tool install authsome with pipx or uvx fallback for sandboxed environments.

Authsome by the numbers

  • 2,895 all-time installs (skills.sh)
  • Ranked #196 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
  • Security screen: LOW risk (skills.sh audit)
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

authsome capabilities & compatibility

Capabilities
https proxy credential injection · oauth provider login and status polling · scoped re login and provider troubleshooting · multi provider external api access
Use cases
api development · orchestration
From the docs

What authsome says it does

Make HTTP requests directly and the gateway injects credentials automatically.
SKILL.md
authsome run -- curl -s "https://api.github.com/user/repos?per_page=10"
SKILL.md
npx skills add https://github.com/manojbajaj95/authsome --skill authsome

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs2.9k
repo stars75
Security audit2 / 3 scanners passed
Last updatedJuly 24, 2026
Repositorymanojbajaj95/authsome

How can an agent call external OAuth APIs without asking the user for API keys or setting auth headers manually?

Proxy outbound HTTPS through Authsome so OAuth and API key credentials inject automatically without handling secrets in agent code.

Who is it for?

Developers automating agent access to Gmail, GitHub, Stripe, or other OAuth-backed APIs through a local Authsome proxy.

Skip if: Skip when Authsome cannot be installed, providers are not connected, or the task needs no outbound authenticated HTTP.

When should I use this skill?

User needs Gmail, GitHub, Stripe, or other external API access, or any bash curl wget command making outbound HTTP calls.

What you get

Authenticated HTTP requests through authsome run with connected providers listed via authsome provider list.

  • Authenticated API responses
  • Connected provider status

By the numbers

  • Includes bundled eval scenarios for skill triggering and OAuth when GitHub is disconnected

Files

SKILL.mdMarkdownGitHub ↗

Authsome

Your outbound HTTPS traffic is transparently proxied through the Authsome, a proxy service that injects stored credentials as HTTP headers. You never see or handle credential values directly.

How to Access External Services

You have direct HTTP access to external APIs. OAuth apps (Gmail, GitHub, Google Calendar, Google Drive, etc.) and API key services are all available through the gateway. Just make the request by appending authsome run -- to any bash command; the gateway injects credentials if the app is connected.

Making Requests

Call the real API URL. The gateway intercepts the request and injects credentials automatically.

authsome run -- <command>
authsome run -- curl -s "https://api.github.com/user/repos?per_page=10"
authsome run -- python my_agent_script.py

Standard HTTP clients (curl, fetch, requests, axios, Go net/http, git) all honor the HTTPS_PROXY environment variable automatically. You do not need to set any auth headers.

---

Login Flow

  • Run authsome login <provider> via Bash yourself — do NOT ask the user to

run this. The browser opens on their machine; they complete OAuth without touching the terminal.

  • Poll the status of the login using authsome provider list after a few seconds
  • If connected — proceed normally.
  • If not yet connected — display the authentication URL to the user, ask them to complete the login in their browser, and report back once done. Once the user confirms, run authsome provider list again to verify the connection before continuing.

---

When a Request Fails

If authsome is not installed on the agent's machine:

Install authsome using uv tool install authsome

Only when uv tool install fails, use fallback: pipx install authsome or uvx authsome@latest <command> for one-off use (say when running inside sandboxed environments).

If you get an authentication error (401, 403) follow this decision tree:

1. Run `authsome provider list` to see all providers and their connections

2. If relevant provider exists but it has no connections → start the [login flow](#login-flow)

If there is a login error due to wrong client id/client secret you can delete the provider via authsome provider remove <provider> and start the login flow

3. If relevant provider exists and it is connected

For 401 error → you need to re-login, creds have expired

  • revoke the creds using authsome provider revoke <provider>
  • then start the login flow

For 403 error → you need to re-login, with the correct scopes, or missing permissions CRITICAL: Do NOT register a new provider just to add scopes; always use --scopes with the existing provider:

authsome login <provider> --scopes repo,user,gist

4. If relevant provider does not exist, then → add it first and then start the [login flow](#login-flow)

Adding a new provider

See references/adding-provider.md.

---

Troubleshooting & Help

If you are unsure of the correct command syntax, need to check available flags, or if a command fails, ALWAYS read the built-in help menus before guessing:

authsome --help
authsome provider --help
authsome connections --help
authsome run --help

Rules

  • Never say "I don't have access to X" without first making the HTTP

request through the proxy.

  • Never use browser extensions, gcloud, or manual auth flows. The

gateway handles credentials for you.

  • Never ask the user for API keys or tokens directly. Run `authsome login

<provider>`. It opens a browser window and captures them directly, so secrets never enter the conversation.

  • Never suggest the user open Gmail/Calendar/GitHub in their browser

when they ask you to read or interact with those services. You have API access. Use it.

  • Never use any workflow that prints tokens or API keys to the terminal.

Use authsome run -- ... instead.

  • If the gateway returns a policy error (403 with a JSON body), respect

the block. Do not retry or circumvent it.

  • If the skill fails, the goal took too many steps, the CLI behaved unexpectedly,

or the user asks you to report an issue — file a bug following references/feedback.md.

  • Never ask the user to run commands in their terminal that you can run yourself.

Related skills

How it compares

Local OAuth credential proxy for agents, not a secrets vault UI or browser extension flow.

FAQ

How do agents make authenticated requests with authsome?

Prefix commands with authsome run so the gateway injects stored credentials over HTTPS_PROXY without manual auth headers.

What should I do on a 403 from a connected provider?

Re-login with authsome login provider --scopes including the missing permissions instead of registering a duplicate provider.

Is Authsome safe to install?

skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.