Mural MCP Server

A Model Context Protocol (MCP) server that provides integration with the Mural visual collaboration platform. This server enables AI assistants to interact with Mural workspaces through OAuth 2.0 authentication.

Note: This is v0.0.1 - an early MVP release focused on workspace listing functionality. More features are planned for future releases.

Features

• OAuth 2.0 Authentication: Secure authentication with PKCE support
• Workspace Management: List and retrieve workspace information
• MCP Compliance: Full Model Context Protocol compatibility
• Token Management: Automatic token refresh and secure storage

Tools Available

• list-workspaces: List all workspaces the authenticated user has access to
• get-workspace: Get detailed information about a specific workspace
• test-connection: Test the connection to Mural API and verify authentication
• clear-auth: Clear stored authentication tokens

Prerequisites

1. Node.js: Version 18 or higher
2. Mural Account: Access to Mural with workspace permissions
3. Mural OAuth App: Register an app at Mural Developer Portal

Installation

Option 1: Install from npm (Recommended)

npm install -g mural-mcp
# or
pnpm add -g mural-mcp

Option 2: Install from source

1. Clone and install dependencies:

git clone https://github.com/your-username/mural-mcp.git
cd mural-mcp
pnpm install

2. Build the project:

pnpm run build

Setup

1. Set up environment variables:

cp .env.example .env
# Edit .env with your Mural OAuth credentials

Configuration

Environment Variables

Create a .env file with the following variables:

# Required: Your Mural app's client ID
MURAL_CLIENT_ID=your_client_id_here

# Optional: Your Mural app's client secret (recommended)
MURAL_CLIENT_SECRET=your_client_secret_here

# Optional: OAuth redirect URI (defaults to http://localhost:3000/callback)
MURAL_REDIRECT_URI=http://localhost:3000/callback

Mural OAuth App Setup

1. Visit Mural Developer Portal
2. Create a new application
3. Set the redirect URI to http://localhost:3000/callback (or your custom URI)
4. Note your Client ID and Client Secret
5. Configure the required scopes: workspaces:read

Usage

With Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "mural": {
      "command": "node",
      "args": ["/absolute/path/to/mural-mcp/build/index.js"],
      "env": {
        "MURAL_CLIENT_ID": "your_client_id_here",
        "MURAL_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

Standalone Usage

Run the server directly: