convex-setup-auth

Set up Convex authentication with the right provider, user management, and access control patterns.

get-convex ↓ 89k
Claude Code
View source ↗

What it does

  • Setting up authentication for the first time
  • Implementing user management (users table, identity mapping)
  • Creating authentication helper functions
  • Setting up auth providers (Convex Auth, Clerk, WorkOS AuthKit, Auth0, custom
  • Auth for a non-Convex backend
  • Pure OAuth/OIDC documentation without a Convex implementation
  • Debugging unrelated bugs that happen to surface near auth code

Requirements & configuration

  • The auth provider is already fully configured and the user only needs a
  • actually needs user documents in Convex. Not every app needs a users table.
  • [ ] Only added app-level user storage if the app actually needs it
  • [ ] Added authorization checks where the app actually needs them

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

Set up Convex authentication with the right provider, user management, and access control patterns.

Source

Repository: https://github.com/get-convex/agent-skills

convex-setup-auth FAQ

What does the convex-setup-auth skill do?

Sets up Convex auth, identity mapping, and access control. Use for login, auth providers, users tables, protected functions, or roles in a Convex app. Setting up authentication for the first time Implementing user management (users table, identity mapping)

What does convex-setup-auth require?

The auth provider is already fully configured and the user only needs a actually needs user documents in Convex. Not every app needs a users table. [ ] Only added app-level user storage if the app actually needs it [ ] Added authorization checks where the app actually needs them

How do I install convex-setup-auth?

Run: npx -y skills add https://github.com/get-convex/agent-skills --skill convex-setup-auth --agent claude-code — the source lives at github.com/get-convex/agent-skills.

Maintain convex-setup-auth?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

convex-setup-auth on getagentictools
[![convex-setup-auth on getagentictools](https://getagentictools.com/badge/skills/get-convex-agent-skills-convex-setup-auth.svg)](https://getagentictools.com/skills/get-convex-agent-skills-convex-setup-auth?ref=badge)
npx agentictools info skills/get-convex-agent-skills-convex-setup-auth

The second line is the CLI lookup for this page — handy in READMEs and docs.