How to Integrate Replit with Mural

1// Node.js — install dependencies
2// Run in Replit Shell:
3// npm install express axios
4
5// Verify secrets are configured
6const required = ['MURAL_CLIENT_ID', 'MURAL_CLIENT_SECRET', 'MURAL_WORKSPACE_ID'];
7for (const key of required) {
8  const val = process.env[key];
9  console.log(val ? `OK: ${key}` : `MISSING: ${key} — add to Replit Secrets (lock icon 🔒)`);
10}

1# Python — Mural OAuth 2.0 flow (mural_oauth.py)
2from flask import Flask, request, redirect
3import requests
4import os
5import base64
6
7app = Flask(__name__)
8
9CLIENT_ID = os.environ['MURAL_CLIENT_ID']
10CLIENT_SECRET = os.environ['MURAL_CLIENT_SECRET']
11REDIRECT_URI = os.environ.get('REPLIT_URL', 'http://localhost:3000') + '/oauth/callback'
12SCOPES = 'murals:read murals:write rooms:read identity:read'
13
14def get_basic_auth():
15    creds = base64.b64encode(f'{CLIENT_ID}:{CLIENT_SECRET}'.encode()).decode()
16    return f'Basic {creds}'
17
18@app.route('/oauth/start')
19def oauth_start():
20    auth_url = (
21        f'https://app.mural.co/api/public/v1/authorization/oauth2/'
22        f'?client_id={CLIENT_ID}&redirect_uri={REDIRECT_URI}'
23        f'&response_type=code&scope={SCOPES}'
24    )
25    return redirect(auth_url)
26
27@app.route('/oauth/callback')
28def oauth_callback():
29    code = request.args.get('code')
30    resp = requests.post(
31        'https://app.mural.co/api/public/v1/authorization/oauth2/token',
32        data={
33            'grant_type': 'authorization_code',
34            'code': code,
35            'redirect_uri': REDIRECT_URI
36        },
37        headers={'Authorization': get_basic_auth(), 'Content-Type': 'application/x-www-form-urlencoded'}
38    )
39    tokens = resp.json()
40    print(f"ACCESS TOKEN: {tokens.get('access_token')}")
41    print(f"REFRESH TOKEN: {tokens.get('refresh_token')}")
42    return f"Authorization complete. Copy tokens to Replit Secrets. Expires in: {tokens.get('expires_in')}s"
43
44if __name__ == '__main__':
45    app.run(host='0.0.0.0', port=3000)

1// Node.js — Mural API client (mural-client.js)
2const axios = require('axios');
3
4const BASE_URL = 'https://app.mural.co/api/public/v1';
5const ACCESS_TOKEN = process.env.MURAL_ACCESS_TOKEN;
6const WORKSPACE_ID = process.env.MURAL_WORKSPACE_ID;
7const ROOM_ID = process.env.MURAL_ROOM_ID;
8
9const api = axios.create({
10  baseURL: BASE_URL,
11  headers: { Authorization: `Bearer ${ACCESS_TOKEN}`, 'Accept': 'application/json' }
12});
13
14async function listRooms() {
15  const res = await api.get(`/workspaces/${WORKSPACE_ID}/rooms`);
16  return res.data.value || [];
17}
18
19async function createMural(title, width = 6000, height = 4000) {
20  const res = await api.post(`/rooms/${ROOM_ID}/murals`, {
21    title,
22    width,
23    height
24  });
25  return res.data.value;
26}
27
28(async () => {
29  const rooms = await listRooms();
30  console.log('Rooms:');
31  rooms.forEach(r => console.log(`  ${r.name} (ID: ${r.id})`));
32
33  const mural = await createMural('Replit Test Workshop');
34  console.log(`Created mural: ${mural.title}`);
35  console.log(`URL: ${mural.sharingLink}`);
36})();

1# Python — add sticky notes in grid layout (add_stickies.py)
2import requests
3import os
4
5ACCESS_TOKEN = os.environ['MURAL_ACCESS_TOKEN']
6BASE_URL = 'https://app.mural.co/api/public/v1'
7
8headers = {
9    'Authorization': f'Bearer {ACCESS_TOKEN}',
10    'Content-Type': 'application/json',
11    'Accept': 'application/json'
12}
13
14def add_sticky_note(mural_id, text, x, y, color='#FFF176', width=200, height=200):
15    payload = {
16        'text': text,
17        'x': x,
18        'y': y,
19        'width': width,
20        'height': height,
21        'backgroundColor': color
22    }
23    resp = requests.post(
24        f'{BASE_URL}/murals/{mural_id}/widgets/sticky-note',
25        json=payload,
26        headers=headers
27    )
28    if resp.status_code in (200, 201):
29        return resp.json().get('value', {})
30    else:
31        print(f'Error adding sticky: {resp.status_code} - {resp.text}')
32        return None
33
34def add_notes_grid(mural_id, notes, start_x=200, start_y=200, cols=4, gap=250):
35    """Place notes in a grid layout."""
36    created = []
37    for idx, note in enumerate(notes):
38        col = idx % cols
39        row = idx // cols
40        x = start_x + col * gap
41        y = start_y + row * gap
42        result = add_sticky_note(mural_id, note['text'], x, y, note.get('color', '#FFF176'))
43        if result:
44            created.append(result)
45    print(f'Added {len(created)} sticky notes')
46    return created
47
48# Example usage
49MURAL_ID = 'your-mural-id-here'  # Replace with actual ID from createMural response
50notes = [
51    {'text': 'What went well this sprint?', 'color': '#A5D6A7'},
52    {'text': 'What could be improved?', 'color': '#EF9A9A'},
53    {'text': 'Action items for next sprint', 'color': '#90CAF9'},
54    {'text': 'Team shoutouts', 'color': '#FFF176'}
55]
56add_notes_grid(MURAL_ID, notes)