https://mcp.trigger.dev/mcp, so an assistant can read runs, trigger tasks, and manage resources without running the CLI.
You sign in with OAuth. Tools that change state need your approval in the dashboard before they run.
Remote vs. CLI
The CLI MCP server runs on your machine throughnpx trigger.dev@latest mcp. The remote server runs on Trigger.dev and has no access to your local files or processes.
Use the remote server when your client supports HTTP MCP servers, or when you cannot install the CLI. Keep the CLI server for anything that touches your machine. These tools exist only in the CLI server:
deploystart_dev_server,stop_dev_server,dev_server_statuswhoami,list_profiles,switch_profileinitialize_project
405.
Connect with OAuth
OAuth is the default. Your client opens a browser, you approve access on a consent page, and the client stores the tokens.- Claude Code
- Cursor
- claude.ai
/mcp in Claude Code and choose Authenticate for trigger./.well-known/oauth-protected-resource. Clients find the authorization server from there. It supports dynamic client registration, client ID metadata documents, and PKCE with S256. Composio and similar platforms connect the same way as any other client, through dynamic client registration.
An OAuth grant stops working after 30 days without use, and 90 days after it was created. Self-hosters can change both limits (see self-hosting). When a grant expires, the client prompts you to sign in again.
Scopes
Each OAuth grant carries a list of scopes. A tool call is denied if the scopes or your role in the organization don’t allow it.Write confirmation
Every tool that changes state asks you to approve the exact call first, such astrigger_task, cancel_run, replay_run, or create_alert. Read tools never ask.
- The assistant calls the tool. The server doesn’t run it and returns a confirmation link instead.
- Open the link and sign in to the dashboard. The page shows the tool, the organization, project, and environment, and the arguments. Values under keys like
secret,token, orpasswordare hidden. - Select Approve.
- Tell the assistant to retry. It calls the same tool with identical arguments, and the call runs once.
MCP_CONFIRMATION_ERROR_MODE=tool-error it comes back as a normal tool error with the link in the message.
Self-hosting
The remote server is off by default. Set these environment variables on the webapp:
Confirmations are stored in the cache Redis, so the webapp needs the
CACHE_REDIS_* variables.
