Connect Claude to the Typeform MCP server (beta)

Use the Typeform MCP server to access and interact with your Typeform data directly from Claude (or another MCP-compatible AI tool). Ask questions, manage Contacts, and take action on forms using natural language, without code, APIs, or CSV exports.

This guide is designed for tech-savvy, non-developer users. It complements the developer documentation and walks you through the setup step by step so you can get started and begin experimenting.

Here, we’ll focus on using Claude to set up and use the Typeform MCP server.

Note: The Typeform MCP server is currently in beta, which means the available tools and setup steps will change. For now, you connect with a personal access token but over time we’ll add more tools, a smoother OAuth-based ‘Sign in with Typeform’ flow, and connectors in the Claude connector directory and ChatGPT apps. If you get stuck during setup, send an email to victor.wu@typeform.com with details and he’ll get back to you as soon as possible.

What is MCP?

MCP (Model Context Protocol) is a standard way for AI tools like Claude to connect to external systems (like Typeform) so they can read data or take actions without you writing API code.

What is the the Typeform MCP server?

The Typeform MCP server is another way to access Typeform. Just like you can access Typeform via typeform.com in your browser, you can access Typeform via Claude or other MCP-compatible AI clients.

At the moment the Typeform MCP server provides:

• Basic read-only access to forms
• Basic read and write access to Contacts

Before you start

You’ll need:

• A Typeform account
• A Typeform personal access token with the appropriate scopes
• An MCP‑compatible AI coding agent/client with access to MCP features (for example, Claude Code or Cursor)

In this article we’ll focus on using Claude Code, but the general approach also applies to other MCP‑compatible clients like Cursor.

Server address for the Typeform MCP

When you add the Typeform MCP server in Claude, you’ll be asked for a server URL (server address). Use one of these URLs, depending on where your Typeform account is hosted:

If you’re not sure which one to use, start with the Global / default URL.

Authenticate with a personal access token

Create a personal access token in Typeform:

1. Log in to your Typeform account and click your avatar in the top‑right corner. Click Your settings.

2. In the left menu, click Personal tokens.

3. Click Generate a new token.

4. Give your token a clear name, choose the scopes you need, and click Generate token.

5. Click Copy to save the token somewhere secure (you won’t be able to see it again in full).

For more detail, see the Typeform API personal access token article.

Connect the Typeform MCP server in Claude

We’ll walk through setting up the Typeform MCP server via Claude Code (Anthropic’s coding/terminal client). Once you’ve added the Typeform MCP server in Claude Code, it will also be available when you use Claude Desktop with the same account.

At a high level, you’ll:

1. Install Claude Code from Anthropic’s site if you don’t already have it installed.
2. Set up the Typeform MCP server in Claude Code (see “Set up the Typeform MCP server in Claude Code” below).
3. (Optional) Install Claude Desktop if you don’t already have it installed and sign in with the same account if you also want to use the Typeform MCP server from the desktop app.

Set up the Typeform MCP server in Claude Code

The easiest way to add the Typeform MCP server in the terminal is to let Claude Code configure it for you.

1. Open Claude Code (from your terminal or wherever you normally use it).
2. In the Claude Code chat, paste this:

Help me add a Typeform MCP HTTP server using my Typeform personal access token.

Use the command:

claude mcp add --transport http typeform --scope user https://api.typeform.com/mcp

and configure an Authorization header with the value MY_TOKEN_HERE (I’ll paste my real token when you ask). Then show me the resulting MCP configuration so I can reuse it later.

Claude Code will then run the command, ask you for your token at the right time, and show you the final MCP configuration. After that, restart Claude Code if needed and run /mcp in the chat to confirm that a typeform server appears in the list.

For client‑specific configuration details (e.g. exact JSON config format, supported transports), refer to Anthropic’s MCP client documentation and the Typeform MCP Server developer guide.

What you can do once connected

Once Claude is connected to the Typeform MCP server, it can call tools that act on your account.

Today, that includes:

• Forms: Read‑only access (for example, listing forms, retrieving definitions)
• Contacts: Create, update, and delete contacts

You may be asked for your Typeform account ID before you can take certain actions. You can find this any time you’re logged into Typeform by looking at your browser’s address bar. The URL will look something like:

https://admin.typeform.com/accounts/ACCOUNT_ID/...

Copy the long string of letters and numbers between accounts/ and the next / and paste that into Claude when it asks for your account ID.

To see what’s currently available in your setup, it’s often easiest to ask Claude to “show all the actions or tools you can perform using the Typeform MCP server”, then follow up with the specific actions you’re interested in.

When we say tools, we mean ready-made actions (for example, “create a contact” or “list my forms”) that Claude can run for you through the Typeform MCP server.

Example things to ask Claude

Once everything is configured and the Typeform MCP server is active, you can start talking to Claude about your Typeform data in plain language. Use prompts like these to discover what’s possible, then layer on more detail as you go:

Discover what Claude can do:

“Show me all the actions/tools the Typeform MCP server can perform for my account and briefly explain each one.”

Create a contact:

“Create a new contact with the name Alex Rivera and email alex@example.com.”

List contacts:

“List all my contacts”

List forms:

“List my forms and show me their titles and IDs.”