Skip to main content
Whimsical logo

Whimsical

Connects Whimsical to FlyMyAI agents through Whimsical's official hosted MCP. Connect your Whimsical workspace once via OAuth and the agent can create and read visual docs - flowcharts, mind maps, wireframes and sequence diagrams - and search files in your workspace. No token to paste.

What it can do​

  • Create flowcharts, mind maps, wireframes and sequence diagrams
  • Search and read files in your Whimsical workspace
  • Read file contents to summarise or iterate on existing boards

The exact verbs are discovered from Whimsical's hosted MCP after you connect, so the list tracks whatever Whimsical currently exposes for your workspace and the scopes you grant.

The agent is granted read + write scopes (mcp:read, mcp:write) but is instructed to confirm with you before any write (creating or updating boards and files).

How to get credentials​

Whimsical uses OAuth - there's no token to copy.

  1. In FlyMyAI, open the Whimsical MCP and start the setup flow.
  2. A Whimsical consent screen opens in a new tab. Sign in with the Whimsical account the agent should act as.
  3. Review the requested scopes and approve.
  4. You're redirected back to FlyMyAI; the tool flips to Configured.

Scopes requested: mcp:read, mcp:write.

To revoke access later, open Whimsical Settings -> Connected apps (or your workspace's integration settings) and remove the FlyMyAI connection.

Fields to fill in FlyMyAI​

No fields - the OAuth flow stores the tokens automatically. To switch Whimsical accounts, remove the tool and connect again with the other account.

Use it from code​

Once Whimsical is connected (above), call it directly from the SDK - no agent required. The same connection also works when you attach the tool to an agent (tools=[whimsical.id]) and let it draw diagrams inside a run.

from flymyai import AgentClient

client = AgentClient(api_key="fly-***")

# Find your connected Whimsical tool (or client.tools.create(mcp_tool="whimsical"))
whimsical = next(t for t in client.tools.list() if t.mcp_tool == "whimsical")

# Call any Whimsical MCP action directly
files = client.tools.call(
    whimsical.id,
    action="search_files",
    arguments={"query": "onboarding flow"},
)
print(files)

The exact verbs are discovered from Whimsical after you connect, so they track whatever your workspace and scopes expose. See Tools & MCP for the full client.tools API.

Troubleshooting​

  • OAuth denied / 403 - your Whimsical role lacks access to the workspace, or an admin restricts third-party apps. Connect with an account that has the needed access.
  • Connected, but some actions are missing - the available actions are limited by the scopes granted at connect time and by your Whimsical plan. Reconnect to refresh.
  • Session expired - reconnect Whimsical in MCP settings; FlyMyAI flags the tool for re-authorization when the access grant is revoked or rotated out.
We love our partners - FlyMy.AI builds with the best. Thanks, Whimsical!