Malloy MCP guide

Claude supports remote custom connectors on Free, Pro, Max, Team, and Enterprise plans. Free accounts can add one custom connector. See the current Claude connector guide.

Quick start

If you already know how to add an MCP, use this quick start.

Before you start

You need:

• A Claude account
• A Malloy Advanced or Malloy Production plan
• Access to add a connector in Claude

If you use a work account, your team owner may need to add Malloy for you.

1. Add the Malloy link

Open the Claude setup page. If the form does not open, click Add. Then click Add custom connector.

Type Malloy in the first box. Paste this link in the second box:

Check the name and link. Then click Continue.

2. Keep the sign-in settings

Claude will find the right settings. Keep Always required on. Keep No client ID — register one automatically on.

You do not need to type a client ID. Click Add.

3. Connect Malloy

Claude will open the Malloy connector page. Click Connect.

4. Allow access

A Malloy page will open. Check that you see the right email. The page should say that Claude wants to connect to Malloy.

The send-to link should start with https://claude.ai/.

Click Allow access.

5. Check that Malloy is ready

You will go back to Claude. Malloy is ready if you see a Disconnect button.

You will also see the Malloy tools. It is safe to keep Needs approval on. Claude will ask before it uses a tool.

6. Try an example: Make a birthday card

Let's try making a birthday card animation. This is a simple example to show you how Malloy works.

Start a new Claude chat. Then send this prompt:

Use the Malloy MCP to generate a birthday card animation.

Open Claude with the birthday prompt

Claude will ask what size you want. Pick Square, Vertical, or Landscape.

7. Answer the questions

Pick a size, a style, and the words for your card. The picture uses Landscape, Rubber Duck, and Happy Birthday.

Claude will ask to use the Malloy tool. Click Allow once for this test.

8. Play and edit your motion graphic

Malloy gives you a motion graphic you can play and change. The two pictures below show both views.

Play the preview

Press play to watch the birthday card move.

Change it and export

Open the side panel. Change the words or colors. Then export your video.

Before you start

You will need:

• The ChatGPT desktop app with Codex mode
• Access to Plugins and custom MCPs
• A Malloy Advanced or Malloy Production plan
• Permission to add MCP servers to your ChatGPT account

Codex is included across ChatGPT plans, but plugin access can vary. Check OpenAI's current plugin availability before you start.

Make sure the Malloy endpoint is exactly https://api.malloy.sg/mcp when you add it.

1. Open Plugins and add an MCP server

In the ChatGPT desktop app, open Codex. Then open Settings and select Plugins. Open the Add menu and choose Add MCP server.

2. Enter the Malloy MCP details

Complete the custom MCP form with these details:

• Name: Malloy
• Type: Streamable HTTP
• URL: https://api.malloy.sg/mcp

Leave the bearer token and header fields empty, then select Save.

3. Authenticate the Malloy connection

Find Malloy in the MCPs list and make sure its switch is on. Select Authenticate to connect your Malloy account.

4. Allow Codex to access Malloy

Your browser will open the Malloy authorization page. Check that you are signed in with the correct Malloy account, then select Allow access. When authorization finishes, return to ChatGPT.

5. Create your first motion graphic

Start a new Codex conversation in the ChatGPT desktop app and tell it to use Malloy. Try this:

Use the Malloy MCP to generate a happy birthday animation.

When ChatGPT asks which format you want, choose 16:9, 9:16, or 1:1.

Return to Codex in the ChatGPT desktop app to try the prompt.

6. Preview and save your animation

Wait for Malloy to finish generating the animation, then play the preview inside Codex. To keep it in your Malloy account, ask:

Can you save this template for me?

ChatGPT will confirm the template name after Malloy saves it.

7. Edit or export your animation

Open the preview's side panel to change the message, colors, and other controls. When you are ready, select Export video.