Mural
Mural is a digital whiteboard platform enabling distributed teams to visually brainstorm, map ideas, and collaborate in real time with sticky notes and diagrams
Verdict
Common use cases
- Seed retrospective boards with AI-generated themes
- Inventory widgets across multiple murals
- Draft sticky notes from meeting transcripts
- List file attachments before a workshop
- Organize feedback into visual clusters
Integration
- Vendor
- Mural
- Category
- other
- Auth
- OAUTH2
- Tools
- 5
- Composio slug
mural
Tools
- Create sticky note
Tool to create one or more sticky note widgets on a mural. use when you need to add notes to a mural layout.
- Get current user
Tool to retrieve information about the currently authenticated user. use when you need current user details after authentication.
- Get files for a mural
Tool to retrieve a list of file widgets in a mural. use after confirming the mural id when listing file attachments.
- Get Mural Widgets
Tool to retrieve all widgets within a specified mural. use after confirming the mural id is correct.
- MURAL Authorization Request
Tool to initiate the oauth 2.0 authorization process. use when you need to redirect a user to mural to obtain an authorization code.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings > Integrations > Mural. 2. Click 'Connect Mural' to start the OAuth flow. 3. You'll land on Mural's authorization page — sign in if prompted, then review the scopes (read workspace content, write sticky notes, read user profile). 4. Click 'Allow' to grant access; Switchy receives the token and stores it securely. 5. Back in Switchy, you'll see 'Mural connected' with a green checkmark. 6. Open any Space and type '@Mural get current user' to confirm the connection returns your Mural profile. 7. To test write access, find a mural ID from your Mural workspace (it's in the URL after /m/), then in Switchy type '@Mural create sticky note on mural [ID] with text Test from Switchy' — check the board to see the new note appear.
What teammates see: by default, memories from Mural are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Seed Retro Board
@Mural create sticky notes on mural m/acme/12345 with these themes from our sprint: three wins, two blockers, one process improvement ideaOpen in a Space →
Inventory Mural Widgets
@Mural get all widgets from mural m/acme/67890 and summarize them by type and countOpen in a Space →
List Attached Files
@Mural get files for mural m/acme/11223 and list their names and upload datesOpen in a Space →
Check My Mural Profile
@Mural get current user and show my workspace name and emailOpen in a Space →
Draft Feedback Notes
@Mural create sticky notes on mural m/acme/44556 from this feedback: users want faster search, clearer onboarding, and dark modeOpen in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Mural show me all the widgets in our Q1 Planning board so I can see what's been added this week
I retrieved 47 widgets from the Q1 Planning mural. The board contains 23 sticky notes (mostly clustered in the 'Priorities' section), 8 text boxes with headers, 6 shapes used as swimlane dividers, 5 images (product mockups), 3 connectors linking ideas, and 2 file attachments. Most recent activity shows 9 sticky notes were added in the past 7 days, primarily around the 'Marketing Launch' area. This illustrates what a typical widget inventory looks like—your actual mural may have different counts and types.
This example demonstrates the read-heavy Get Mural Widgets tool, which returns structured data about every element on a board. You'll need the exact mural ID (usually from a URL or prior lookup). The response helps you audit board state or feed content into downstream analysis, but doesn't include widget positions or detailed formatting.
@Mural create sticky notes for these three action items: 'Finalize pricing model', 'Schedule customer interviews', 'Update roadmap deck'
I created 3 sticky notes on your mural. Each note contains one of your action items as text. The notes were placed at default coordinates since no specific layout was provided—you'll likely want to drag them into the appropriate section of your board. Note IDs: sn-abc123, sn-def456, sn-ghi789. This example shows how the MCP can programmatically add content, though it doesn't auto-organize or assign owners.
This write example uses the Create Sticky Note tool to add content directly to a mural. The MCP requires a target mural ID and will place notes at default positions unless you specify coordinates. It's ideal for bulk-adding brainstorm outputs or meeting notes, but you'll still need to manually arrange and style the notes in Mural's UI afterward.
@Mural pull all file attachments from our Design Review board and summarize what assets the team has uploaded
I found 4 file widgets in the Design Review mural: 'homepage-wireframe-v3.fig' (Figma file, 2.1 MB, uploaded 3 days ago), 'user-research-findings.pdf' (PDF, 890 KB, uploaded last week), 'brand-guidelines.pdf' (PDF, 1.4 MB, uploaded 2 weeks ago), and 'prototype-demo.mp4' (video, 15 MB, uploaded yesterday). The team appears to be iterating on homepage designs while referencing research and brand standards. This illustrates typical file metadata—actual download or preview requires separate access to the linked files.
This synthesis example combines the Get Files for a Mural tool with AI reasoning to provide context about attached assets. The MCP returns file metadata (names, sizes, upload dates) but not file contents—you'd need separate integrations or manual downloads to analyze the actual documents. Useful for inventory checks or spotting missing deliverables before a review meeting.
Use-case deep-dives
When Mural MCP works for async brainstorm capture
A 6-person design consultancy runs client discovery workshops in Mural, then needs to pull sticky notes and file attachments into Switchy for synthesis. The MCP's create-sticky and get-widgets tools let you push AI-generated themes back onto the board or pull all notes into a Switchy thread for clustering. This works if your workshop cadence is weekly or slower—OAuth2 setup takes a few clicks per workspace, and the 5-tool scope means you're mostly moving text and files, not editing shapes or timers. If you're running daily retros or need to manipulate complex canvas objects, the MCP is too narrow. For monthly or quarterly workshops where the output is a summary doc, this MCP closes the loop between whiteboard and writeup.
Mural MCP for templated board creation at scale
A 3-person People Ops team maintains onboarding murals for each new hire cohort and wants to auto-populate sticky notes from a Switchy prompt (role-specific tasks, links, welcome messages). The create-sticky tool handles batch creation, and get-files confirms attachments landed. This scenario wins if you're spinning up 5-10 boards a month and the content is text-heavy—think checklists, not diagrams. The MCP doesn't create frames or connectors, so if your onboarding flow is a visual journey map, you'll still template that by hand. For text-based task boards where speed matters more than layout polish, the MCP cuts 20 minutes per board. Buy this if your onboarding murals are 80% sticky notes and you're tired of copy-paste.
When Mural MCP handles affinity mapping at small scale
A 4-person product team collects user interview quotes in Mural and wants AI to tag themes across 30-50 sticky notes per research sprint. The get-widgets tool pulls all notes into Switchy, where you cluster and label, then create-sticky pushes theme headers back to the board. This works if your research cadence is biweekly and your murals stay under 200 widgets—beyond that, the MCP's read-all approach gets slow and you're better off exporting CSV. The 5-tool limit also means no voting dots or timer widgets, so this is pure affinity mapping, not prioritization. If your research output is a tagged board that feeds a roadmap doc, the MCP saves 30 minutes per sprint. Skip it if you need real-time collaboration or complex board interactions.
Frequently asked
What does the Mural MCP let me do in Switchy?
It lets your AI agents read and write to Mural boards—creating sticky notes, listing widgets, and pulling file attachments. Think of it as giving your team's AI the ability to participate in visual brainstorming sessions, extract ideas from existing boards, or populate new murals with structured data without opening the Mural app.
Do I need admin permissions in Mural to connect it?
No. Any Mural user can authorize the OAuth connection. The MCP acts with the permissions of whoever connects it, so if you can view and edit a board in Mural, the AI can too. Team admins don't need to approve the integration separately unless your Mural workspace enforces custom OAuth policies.
Can the MCP move or edit existing sticky notes on a board?
No. The current toolset only creates new sticky notes and reads existing widgets—it can't reposition, update text, or delete items you've already placed. If you need to modify a board layout, you'll still do that manually in Mural or via their REST API outside Switchy.
Why use this instead of just opening Mural myself?
Speed and context. Your AI can drop structured research findings or meeting notes onto a board in seconds, formatted as sticky notes, without you switching apps. It's faster than copy-pasting and keeps the AI in the loop when your team references board content in later conversations.
Who on my team should connect the Mural account?
Whoever owns the boards your team references most. The AI inherits that person's Mural permissions, so connect an account that has edit access to your key workspaces. If multiple people need different board access, you can reconnect with a different Mural user anytime.