Use Wavelength inside Claude and ChatGPT
Claude
ChatGPT
Ask Claude or ChatGPT to map a process, list your flows, or edit a flow in plain English. Sign in with your Wavelength account. No API key.
Flows now show as an interactive diagram inside the chat. You can pan, zoom, and drag nodes, then open the flow in Wavelength to keep editing.
Server URL
Copy this URL and paste it into Claude or ChatGPT when you add a custom connector.
https://wavelengthflow.com/api/mcp
How to connect
Claude
- Copy the connector URL.
- In Claude, open Customize, then Connectors.
- Click Add, then Add custom connector.
- Name it Wavelength, paste the URL, click Add.
- Click Connect, sign in with your Wavelength account, and click Approve.
- In a new chat, click + and turn on Wavelength.
ChatGPT
- In ChatGPT, open Settings, then Security and login, and turn on Developer mode.
- Open Plugins in the sidebar, click the + button, then Create app, then Create MCP App.
- Name it Wavelength, paste the connector URL, and set Authentication to OAuth.
- Tick "I understand and want to continue", click Create, sign in with your Wavelength account, and click Approve.
- In a new chat, click + and select Wavelength.
Already connected before September 24, 2026? We moved the connector to a new sign-in. In Claude, open Customize, Connectors, Wavelength, click Disconnect, then Connect. In ChatGPT, open Settings, Plugins, Wavelength, delete the app, then add it again with the same URL. A reconnect alone does not work in ChatGPT.
Connect a coding tool
The same URL works in coding tools that support remote MCP servers with OAuth. Add the server, then sign in with your Wavelength account when the tool asks. These setup steps follow each tool's own documentation. If a step does not match your version, check the tool's MCP help page.
Claude Code
Run this command in your terminal, then type /mcp in Claude Code and select Wavelength to sign in.
claude mcp add --transport http wavelength https://wavelengthflow.com/api/mcpCursor
Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Then open Cursor Settings, MCP, and click Connect next to Wavelength.
{
"mcpServers": {
"wavelength": { "url": "https://wavelengthflow.com/api/mcp" }
}
}VS Code (GitHub Copilot)
Add this to .vscode/mcp.json in your project, or run MCP: Add Server from the Command Palette. Click Start above the server, then sign in when VS Code asks.
{
"servers": {
"wavelength": { "type": "http", "url": "https://wavelengthflow.com/api/mcp" }
}
}Windsurf
Add this to ~/.codeium/windsurf/mcp_config.json, then refresh the MCP servers in Windsurf and sign in.
{
"mcpServers": {
"wavelength": { "url": "https://wavelengthflow.com/api/mcp" }
}
}The tools
Read tools change nothing. Write tools change your own Wavelength data. Sensitive writes delete data, make a flow public, give another person access, or write to an outside system.
Flows
| Tool | Type | What it does |
|---|---|---|
create_flow_from_text | Write | Turns a transcript, call notes, or a spoken description into a saved flow. Nodes are auto-laid out. |
create_flow_from_graph | Write | Creates a flow from explicit nodes and edges, with no AI call. Nodes are auto-laid out. |
import_diagram | Write | Turns an existing diagram or automation into editable flows, with no AI call. Accepts Mermaid, draw.io XML, SVG, n8n workflow JSON, a Zapier export (zapfile.json), or a dbt manifest.json. |
list_n8n_workflows | Read | Lists the workflows in your connected n8n instance. |
import_from_n8n | Write | Maps n8n workflows into new flows, one flow per workflow, with no AI call. |
list_dbt_jobs | Read | Lists the jobs in your connected dbt Cloud account. |
import_dbt_lineage | Write | Maps dbt lineage (sources, models, exposures) from a dbt Cloud job into a flow, with no AI call. |
list_snowflake_databases | Read | Lists the databases your connected Snowflake role can see. |
import_snowflake_lineage | Write | Maps lineage in one Snowflake database (views, writes, loads) into a flow, with read-only queries and no AI call. |
list_flows | Read | Lists your saved flows, with optional title query and folder filter. |
search_flows | Read | Full-text searches your flows by title, node labels, and transcript. |
query_flows | Read | Structured query across all your flows: filter by system, data store, owner, node type, what a node connects to, or AI-inferred connections. No AI cost. |
get_flow | Read | Reads one flow, including owner, public status, my_role, and a Mermaid version. Transcript is optional. |
show_flow | Read | Show any saved flow as an interactive diagram in the chat. |
edit_flow | Write | Applies a plain-language edit and saves a version. |
update_graph | Write | Applies exact node and edge edits with no AI call, and saves a version. |
add_to_flow | Write | Merges new notes into an existing flow and appends them to the transcript. |
rename_flow | Write | Changes the title of a flow. |
duplicate_flow | Write | Copies a flow into a new flow with the same steps and links. |
delete_flow | Sensitive write | Permanently deletes a flow. Cannot be undone. |
export_flow | Read | Exports a flow as Mermaid, JSON, SVG, or draw.io. |
review_flow | Read | Runs a deterministic gap check and lists questions to ask on the next call. |
summarize_flow | Read | Summarizes a flow as a recap email, a statement of work outline, or a systems-in-scope list. |
compare_versions | Read | Compares two saved versions, or one version against the current flow. |
History
| Tool | Type | What it does |
|---|---|---|
list_versions | Read | Lists the saved version snapshots for a flow. |
restore_version | Write | Restores a saved version, after saving a snapshot of the current flow. |
Folders
| Tool | Type | What it does |
|---|---|---|
list_folders | Read | Lists your folders and the folder limit for your plan. |
create_folder | Write | Creates a folder. Personal folders need a paid plan. With an organization id, creates an organization folder. |
rename_folder | Write | Renames a folder. |
delete_folder | Sensitive write | Deletes a folder. Flows inside go back to unfiled and are not deleted. |
move_flow_to_folder | Write | Moves a flow into a folder, or unfiles it. |
list_teams | Read | Lists the teams you belong to. With an organization id, lists every team in that organization and each member's team role. |
move_flow_to_team | Write | Assigns a flow to a team, or removes it. |
list_organizations | Read | Lists your organizations, your role, the member count, and the Pro seat count. |
create_organization_team | Write | Creates a team inside an organization. Owners and admins only. |
manage_team_member | Write | Adds a person to a team, changes their team role (team admin, editor, or viewer), or removes them. |
move_flow_to_organization | Write | Moves a flow into an organization so every member can open it, or back out. |
get_organization | Read | Shows an organization: members and roles, Pro seats, seats in use, pending invitations, and settings. |
create_organization | Write | Creates an organization. You become its owner. |
update_organization | Write | Renames an organization or changes its member settings. Owners and admins only. |
invite_member | Sensitive write | Invites a person by email as member or admin. Each member and each pending invitation uses one Pro seat. If no seat is free, the tool says so. |
revoke_invite | Write | Cancels a pending invitation. Owners and admins only. |
set_member_role | Sensitive write | Changes a member role to owner, admin, or member. Only an owner can make or change an owner. |
remove_member | Sensitive write | Removes a person from an organization. Their organization flows go to a member who stays. |
leave_organization | Sensitive write | Takes you out of an organization. The only owner cannot leave. |
get_org_audit_log | Read | Lists recent organization events: who did what and when. Owners and admins only. |
delete_organization | Sensitive write | Deletes an organization permanently. Owner only. You must type the exact organization name to confirm. |
Sharing
| Tool | Type | What it does |
|---|---|---|
share_flow | Sensitive write | Creates or refreshes a public read-only link. Also returns a live image link and Markdown to embed the flow in Notion, Confluence, GitHub, or any page. The image updates when the flow changes. |
unshare_flow | Write | Turns off the public link for a flow. |
get_share_status | Read | Reads the public sharing status, view count, and summary. |
list_collaborators | Read | Lists the collaborators on a flow, with their role (editor or viewer). |
add_collaborator | Sensitive write | Invites a collaborator by email, with a role. Calling again with a new role changes it. Collaboration needs the Pro plan. |
remove_collaborator | Sensitive write | Removes a collaborator from a flow. |
prepare_live_session | Read | Gets a flow ready to present live on a call. Returns the presenter link and the steps. You click Go live in the app; the app then makes the guest link. The tool cannot start or end a session. |
AI help
| Tool | Type | What it does |
|---|---|---|
ask_flow | Read | Answers a question about one flow. The answer uses only the facts in the flow. |
suggest_followups | Read | Finds the gaps in a flow and writes 3 to 6 follow-up questions for the customer. It uses the saved call transcript when there is one. |
write_recaps | Read | Writes three recaps of a flow: an email to the customer, handoff notes for the implementation team, and a short note for a manager. |
group_notes | Read | Groups a list of notes, such as workshop sticky notes, by theme. Nothing is saved. |
notes_to_flow | Write | Turns a list of notes into a process flow and saves it as a new flow. |
format_flow | Write | Marks steps yellow or red from a plain-language rule, or clears the marks. It saves a version first. |
Insights, check-ins, and portals
| Tool | Type | What it does |
|---|---|---|
get_insights | Read | Finds patterns across all your flows: common systems and people, repeated steps, flagged and slow steps, and flows due for a check-in. AI patterns are optional. |
get_checkin_status | Read | Shows when a flow was last confirmed as correct and when the next check-in is due. |
update_checkin | Write | Confirms that a flow is still correct, or sets the check-in interval. |
list_portals | Read | Lists your client portals and their links. |
save_portal | Sensitive write | Creates or updates a client portal. A portal is a public page that shows a set of your flows to a client. |
delete_portal | Sensitive write | Deletes a client portal. The portal link stops working. The flows stay. |
Connected apps and channels
| Tool | Type | What it does |
|---|---|---|
list_connections | Read | Shows which apps you connected to Wavelength and the tool that sends a flow to each app. You connect apps in Wavelength settings, because a sign-in in the browser is necessary. |
list_channels | Read | Lists your Slack, Microsoft Teams, Google Chat, Discord, and webhook channels. |
send_flow_to_channel | Sensitive write | Posts a flow summary and link to one of your channels or webhooks. |
crm_status | Read | Reads whether HubSpot is connected for your account. |
search_crm_deals | Read | Searches your HubSpot deals by name. |
attach_flow_to_crm | Sensitive write | Attaches a flow, a summary, and a share link to a HubSpot deal as a note. |
find_salesforce_records | Read | Searches your Salesforce opportunities or accounts by name. |
send_flow_to_salesforce | Sensitive write | Attaches a flow summary and link to a Salesforce opportunity or account as a note. |
find_notion_pages | Read | Searches the Notion pages that you shared with Wavelength. |
send_flow_to_notion | Sensitive write | Saves a flow as a new Notion page, with a summary, questions, and the Mermaid code. |
find_confluence_targets | Read | Searches your Confluence spaces and pages. |
send_flow_to_confluence | Sensitive write | Makes a new Confluence page from a flow, or adds the flow to an existing page. |
find_jira_targets | Read | Searches your Jira projects and issues, and lists the issue types of a project. |
send_flow_to_jira | Sensitive write | Makes a new Jira issue from a flow, or adds the flow as a comment on an issue. |
find_servicenow_records | Read | Searches your ServiceNow incidents, changes, problems, or requested items. |
send_flow_to_servicenow | Sensitive write | Adds a flow as a work note on a ServiceNow record, or makes a new record. |
save_flow_to_drive | Sensitive write | Saves a flow to the Wavelength folder in your Google Drive as a Google Doc, draw.io, SVG, Mermaid, or JSON file. |
import_from_google_drive | Write | Reads a Google Doc, Sheet, Slides, or a text, transcript, PDF, Word, draw.io, Mermaid, or SVG file from your Drive and makes a flow from it. With import_only, returns the text and makes no flow. Wavelength opens only files it created or files you picked in Wavelength. |
Account
| Tool | Type | What it does |
|---|---|---|
get_account | Read | Shows your plan, flow count, trial end date, folder limit, and mic usage. |
Sample prompts
Paste one into a chat with the Wavelength connector turned on.
Call notes to a flow
Use the Wavelength connector. Turn my call notes below into a process flow diagram. 1. Call create_flow_from_text with the notes and a clear title. 2. Call get_flow for the new flow. 3. List every actor, system, decision, and data store in the flow. 4. List any step the notes did not make clear, as questions for my next call. 5. Give me the link to the flow. Notes: [paste your notes here]
Edit a saved flow
Use the Wavelength connector. Edit my [flow name] flow. 1. Call list_flows and find the flow by name. 2. Call get_flow and show me the current steps. 3. Call edit_flow to add [change, for example Slack alerts after dbt]. 4. Call get_flow again and show me what changed. 5. Give me the link to the flow.
Share a flow with a client
Use the Wavelength connector. Get my [flow name] flow ready to send to a client. 1. Call list_flows and find the flow by name. 2. Call get_flow and write a 3 sentence summary of the process for a business reader. 3. Call share_flow to create a public read only link. 4. Write a short follow up email with the summary and the link.
Flow to Mermaid for docs
Use the Wavelength connector. Get my [flow name] flow into our docs. 1. Call list_flows and find the flow by name. 2. Call export_flow with format Mermaid. 3. Show the Mermaid code in one code block. 4. Write a short README section that explains each step of the flow.
Current state and future state
Use the Wavelength connector. Map the current state and the future state of this process. 1. Call create_flow_from_text with my description of the current process, titled "[process] current state". 2. Call create_flow_from_text again with the changes below, titled "[process] future state". 3. Call get_flow for both flows. 4. Show a table of the steps that change, the steps that are new, and the steps that go away. Current process: [describe it]. Changes: [describe them]
Review my flows
Use the Wavelength connector. Review my saved flows. 1. Call get_account and tell me my plan and flow count. 2. Call list_flows. 3. Show a table with flow name, last updated date, and link. 4. Tell me which flows look like duplicates.
Add a follow-up call to a flow
Use the Wavelength connector. I have new notes from a follow-up call to add to an existing flow. 1. Call list_flows and find the flow by name. 2. Call add_to_flow with the flow id and the new notes. 3. Call get_flow and show me what changed. 4. Give me the link to the flow.
Organize my flows
Use the Wavelength connector. Organize my saved flows into folders. 1. Call list_folders and show me my current folders. 2. Call create_folder for any folder I ask for that does not exist yet. 3. Call list_flows. 4. Call move_flow_to_folder for each flow to put it in the right folder. 5. Show the result as a table with flow name and folder.
Turn a drawn diagram into an editable flow
Use the Wavelength connector. 1. Draw the process below as a simple SVG flowchart. 2. Call import_diagram with the SVG to save it as an editable Wavelength flow. 3. Call get_flow and list any connector that did not come across. 4. Give me the link to the flow. Process: [describe it]
Security
Sign-in uses OAuth. Each tool acts only as the signed-in user. Your plan limits apply the same way as in the app. Transcripts are never used to train a model. Read the full privacy policy.
Read-only mode. To let AI tools read your flows but never change them, open Wavelength, then Settings, AI connector, and turn on read-only mode. Every write tool then refuses with a clear message. Only you can turn it off, from inside the app.
Frequently asked questions
Do I need a Wavelength account?
Yes. A free account works, and new accounts get a 7 day Pro trial with no card required.
Which AI apps can use it?
Claude, ChatGPT, Claude Code, Cursor, VS Code with GitHub Copilot, and Windsurf. In ChatGPT, turn on Developer mode first. Any MCP client that supports remote servers with OAuth can connect to the same URL.
Can an AI tool change my flows by mistake?
Turn on read-only mode in Settings, AI connector. The AI can still list, read, search, summarize, and export your flows, but it cannot create, edit, share, or delete anything.
Can I bring a diagram from another tool?
Yes. Ask the AI to call import_diagram with Mermaid code, draw.io XML, or an SVG. The shapes become nodes and the connectors become edges. Exact positions and colors are not kept.
Does it cost extra?
No. It uses your normal Wavelength plan.