---
title: "Connecting Tugger to Cursor"
slug: "connecting-tugger-to-cursor"
updated: 2026-03-11T20:02:08Z
published: 2026-03-11T20:02:08Z
canonical: "docs.tuggerapp.com/connecting-tugger-to-cursor"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tuggerapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting Tugger to Cursor

# Connecting Tugger to Cursor

This guide walks you through connecting Tugger AI Insights to Cursor, so you can ask questions about your business data in natural language directly from your Cursor chat.

Setup takes around 5 minutes.

## What you'll need

- A **Tugger account** with at least one active connector that has completed its first sync
- **MCP access enabled by your Tugger admin** - by default, users have no MCP access. Your admin needs to grant you access on the User Permissions tab in [MCP Configuration](/docs/tugger-mcp-configuration) before you can connect.
- **Cursor** installed on your computer - download it from [cursor.com](https://www.cursor.com) if you have not already. A free plan is sufficient to get started.

## Step 1: Open Cursor Settings

1. Open Cursor
2. Click the **cog icon** (bottom-left of the window)
3. Select **Settings** from the dropdown menu
4. In the Settings sidebar, click **Tools & MCP**

You will see the Tools & MCP panel. If no MCP servers have been added yet, it will show "No MCP Tools" with an **Add Custom MCP** button.

![Screenshot: Cursor Settings - Tools & MCP panel showing No MCP Tools and Add Custom MCP button](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/cursor-tools-and-mcp.jpg)

## Step 2: Add the Tugger MCP server

1. Click **Add Custom MCP**

This opens the **mcp.json** configuration file. Add the Tugger server entry so the file looks like this:

```
{
  "mcpServers": {
    "tugger": {
      "url": "https://mcp.tuggerapp.com/mcp"
    }
  }
}
```

![Screenshot: Cursor mcp.json file with Tugger server URL entered](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/cursor-tools-and-mcp-alt.jpg)

1. Press **Ctrl+S** (or **Cmd+S** on Mac) to save the file

## Step 3: Authorise the connection

After saving, go back to the **Tools & MCP** settings panel. Tugger will now appear under Installed MCP Servers with a yellow dot and a **Connect** button, indicating it needs authentication.

![Screenshot: Cursor Tools & MCP showing tugger with ](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/cursor-needs-authentication.jpg)

1. Click **Connect**
2. Your browser will open and you will see the Tugger login screen - log in with your Tugger credentials

![Screenshot: Tugger OAuth login/authorisation screen](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/tugger-login.jpg)

1. Review the permissions and click **Authorise**
2. Once authorised, the browser window will remain open - you can close it manually and return to Cursor

## Step 4: Restart Cursor

After authorising, you must restart Cursor for the changes to take effect.

1. Close Cursor completely
2. Reopen Cursor

Once restarted, go to **Settings > Tools & MCP**. Tugger should now show a green dot and display **8 tools enabled**, confirming the connection is active.

![Screenshot: Cursor Tools & MCP showing tugger with green dot and 8 tools enabled](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/cursor-tugger-enabled.jpg)

> **Note:** Your Tugger admin controls which connectors you can access through AI Insights. If you cannot see data from a particular connector, ask your admin to check your permissions in [MCP Configuration](/docs/tugger-mcp-configuration).

## Step 5: Start asking questions

You are all set. Open a new chat in Cursor and start asking about your data.

Try one of these to get started:

- *"What connectors do I have access to in Tugger?"* - a good first question to confirm what data is available
- *"Show me a summary of my data"* - lets the AI explore what is there
- *"Can you give me a breakdown of customers by industry sector in a table?"* - if you have a CRM connector like HubSpot

![Screenshot: Cursor chat showing a question about HubSpot customers by industry sector with a table result](https://cdn.document360.io/915cfc9e-45d4-4924-af8d-4cea920ef985/Images/Documentation/cursor-asking-a-question.jpg)

For more example prompts and tips on getting the best answers, see [Tips for Getting the Best Results from AI Insights](/docs/tips-for-getting-the-best-results-from-ai-insights).

## Troubleshooting

**"Add Custom MCP" button does not appear**

- Make sure you are in Settings > Tools & MCP. Access Settings by clicking the cog icon and selecting Settings from the dropdown.

**Tugger shows "Needs authentication" but clicking Connect does nothing**

- Check that your browser is not blocking popups from Cursor.

**Tugger still shows "Needs authentication" after authorising**

- Make sure you fully restarted Cursor after completing the OAuth flow. A full close and reopen is required.
- Remember to close the browser window that opened during authorisation before restarting Cursor.

**Connected but no data showing**

- Check that at least one connector has completed its first sync in Tugger.
- Ask your Tugger admin to check your access level on the User Permissions tab in MCP Configuration. By default, users have No Access and need to be granted permission.

**Getting unexpected or incomplete results**

- Try being more specific in your questions - see [Tips for Getting the Best Results from AI Insights](/docs/tips-for-getting-the-best-results-from-ai-insights).
- Make sure the connector containing the data you are asking about is included in your MCP access permissions.

**Need to disconnect or reconnect?**

- In Cursor: open Settings > Tools & MCP, toggle Tugger off or remove it, then follow this guide again to reconnect.
- In Tugger: your admin can deactivate the OAuth client from the OAuth Clients tab in MCP Configuration.

---

**Related articles:**

- [What is Tugger AI Insights?](/docs/what-is-tugger-ai-insights)
- [Tips for Getting the Best Results from AI Insights](/docs/tips-for-getting-the-best-results-from-ai-insights)
- [Tugger MCP Configuration](/docs/tugger-mcp-configuration)