Mural MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Mural MCP or direct API to brainstorm visually, create and organize sticky notes, manage whiteboards, and facilitate seamless team collaboration through natural language.

Mural logoMural
Oauth2

Mural is a digital whiteboard platform for distributed visual collaboration. It helps teams brainstorm, map ideas, and diagram together in real time.

22 Tools

Try Mural now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Mural
Try asking
TOOLS

Supported Tools

Every Mural action and event your agent gets out of the box.

MURAL Authorization Request

Tool to initiate the OAuth 2.

Create sticky note

Create one or more sticky note widgets on a mural.

Get current user

Tool to retrieve information about the currently authenticated user.

Get files for a mural

Tool to retrieve a list of file widgets in a mural.

Get Mural Widgets

Tool to retrieve all widgets within a specified mural.

Get room by ID

Tool to retrieve information about a specific room by its ID.

Get workspace by ID

Tool to retrieve information about a specific workspace by its ID.

Get workspaces

Tool to retrieve all workspaces the authenticated user is a member of.

List folders in room

Tool to list all folders within a room that the authenticated user has access to.

List open rooms in workspace

Tool to list all discoverable open rooms within a workspace.

List recent murals in workspace

Tool to list recently opened active murals for the authenticated user in a workspace.

List recent templates

Tool to retrieve recent templates used by a user for a workspace.

List murals in room

Tool to list all murals for a room that the authenticated user has read access to.

List rooms in workspace

Tool to list all rooms within a workspace.

List users in room

Tool to list all members and guests for a room.

List tags in a mural

Tool to retrieve all tags in a mural.

List default templates

Tool to retrieve all default templates available in Mural.

List workspace murals

Tool to list all murals in a workspace that the authenticated user owns or is a member of.

List workspace templates

Tool to get default and custom templates for a workspace.

Search murals in workspace

Tool to search for murals within a workspace.

Search rooms in workspace

Tool to search for rooms within a workspace by name or description.

Search templates in workspace

Tool to search templates within a workspace that the authenticated user owns or has access to.

SETUP GUIDE

Connect Mural MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["mural"],
  mcp: true,
});
Create a session scoped to Mural and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Add three sticky notes to the brainstorm mural summarizing today's ideas.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Mural request
SETUP GUIDE

Connect Mural API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["mural"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Mural
3

Run Mural tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Add three sticky notes to the brainstorm mural summarizing today's ideas." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Mural tool calls through the session, and print the final answer

Why Use Composio?

AI Native Mural Integration

  • Supports both Mural MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Mural data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Mural access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Mural
  • Scoped, least privilege access to Mural resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

No. Composio provides a managed OAuth app for Mural, so you sign in with your normal Mural account and approve access. If you later want the consent screen to show your own company name, you can add your own Mural OAuth app in the Composio dashboard, and every connection after that uses it.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Mural connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a Mural account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Mural as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Mural lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Mural administrator may need to approve the app first, and you can revoke the access inside Mural whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Mural connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Mural tokens automatically, so day to day you do nothing. If you revoke access inside Mural, or Mural invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free plan includes 100,000 tool calls per month with no credit card, and up to 20,000 of those can run through Composio-managed apps like Mural. Personal Mural use rarely gets near that. Paid plans add higher limits and team features, and Mural's own pricing is unaffected.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Mural accounts).

With Composio, you connect Mural once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Mural.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Mural tool your agent needs.Free to start.

Start building