Connect Envelope to ChatGPT
Add Envelope as an app in ChatGPT and your design workspace appears as a set of tools inside any conversation. Generate team specs, update designs, browse your template library, and manage your workspace — without leaving your chat.
What you get
Once connected, ChatGPT has access to Envelope's design and workspace tools:
Workspace
| Tool | What it does |
|---|---|
| list_installs | Shows all teams in your workspace — name, status, and last run |
| list_templates | Lists your template library — what's published and available to install |
Build
| Tool | What it does |
|---|---|
| generate_team | Generates a team definition from a natural-language description |
| create_team | Saves a team definition as a private draft template |
| update_team | Modifies an existing template using a natural-language instruction |
| install_team | Installs a template into your workspace so it can be triggered |
| uninstall_team | Removes an installed team |
| publish_team | Publishes a draft template to the public marketplace |
Model routing
| Tool | What it does |
|---|---|
| get_agent_models | Lists each agent in an install with its current model assignment |
| set_agent_model | Pins a specific model to an agent (overrides auto-routing) |
| reset_agent_model | Clears a model override, returning the agent to automatic routing |
How to connect
ChatGPT uses OAuth for third-party app connections. You'll be redirected to Envelope to sign in and approve access.
Step 1 — Open your ChatGPT settings
Go to chatgpt.com. Click your profile icon in the top-right. Select Settings.
Step 2 — Find the Apps section
In the left sidebar, look for Connectors or Apps (the exact label depends on your ChatGPT plan). Click Add app or New App.
Step 3 — Paste the server URL
Enter:
https://mcp.openenvelope.org/api/mcpStep 4 — Complete the OAuth flow
ChatGPT will redirect you to an Envelope sign-in page. Enter your email — Envelope sends a magic link. Click it to complete sign-in.
Step 5 — Approve access
You'll see a consent screen listing the tools ChatGPT will be able to call on your behalf. Approve. You're connected.
Using it in a conversation
Generating an agent spec
"Generate an AI team that researches new HubSpot leads and scores them against our ICP"
ChatGPT calls generate_team, builds the spec — roles, tools, reporting lines — and returns it ready to save or refine.
Updating a design
"Add a human approval gate before the outbound email agent sends anything"
ChatGPT calls update_team with your instruction and returns the revised spec.
Browsing your library
"What team templates do I have saved?"
ChatGPT calls list_templates and lists everything in your workspace by name and status.
Plan requirements
The ChatGPT Apps/Connectors feature is available on Plus, Team, and Enterprise plans. It is not available on the free plan.
Troubleshooting
"I don't see a Connectors or Apps option"
This feature requires a paid ChatGPT plan. It also requires that Connectors or Actions are enabled for your workspace (Teams and Enterprise accounts control this at the org level — check with your admin).
"The OAuth flow failed"
Try again in an incognito window. If you were already signed into Envelope in that session, it sometimes conflicts. Signing out of Envelope first and going through the flow fresh usually resolves it.
"Connected but tools aren't being used"
You may need to explicitly ask ChatGPT to use the tool: "Use the Envelope list_installs tool to show my teams." ChatGPT will proactively use tools when they're relevant, but being explicit forces a call.
"I get an error when running a team"
Make sure the team you're asking about is installed (not just a template). You can check with: "List my installed Envelope teams." Templates need to be installed before they can be run.
Disconnect
To remove the connection, go to Settings → Connectors / Apps, find Envelope, and click Remove or Revoke. This revokes ChatGPT's access token — your Envelope data is unaffected.