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

# n8n

> Connect n8n workflows to Minoa via MCP

## Overview

Connect **n8n** to your **Minoa** workspace to build automated workflows powered by your sales data. Use n8n as a bridge to connect Minoa with hundreds of other tools.

<Warning>
  This integration is currently in **beta**. Reach out to [support@minoa.io](mailto:support@minoa.io) to get access.
</Warning>

## Use Cases

| Scenario              | Description                                              |
| --------------------- | -------------------------------------------------------- |
| **Pipeline alerts**   | Trigger Slack messages when deals reach certain stages   |
| **CRM sync**          | Keep Minoa and your CRM in sync with automated workflows |
| **Custom dashboards** | Pull Minoa data into Google Sheets or other tools        |

***

## Getting Started

### Prerequisites

* n8n Cloud account (or self-hosted instance)
* Minoa account with MCP enabled

***

### Step 1: Create MCP OAuth Credential

1. In n8n, go to **Credentials** → **Add Credential**
2. Search for **MCP OAuth2 API**
3. Configure the credential:

| Field                               | Value                            |
| ----------------------------------- | -------------------------------- |
| **Use Dynamic Client Registration** | OFF (toggle off)                 |
| **Grant Type**                      | Authorization Code               |
| **Authorization URL**               | `https://mcp.minoa.io/authorize` |
| **Access Token URL**                | `https://mcp.minoa.io/token`     |
| **Client ID**                       | `mcp_n8n`                        |
| **Scope**                           | `read`                           |
| **Authentication**                  | **Body** (important!)            |

<Warning>
  **Important**: Make sure "Authentication" is set to **Body**, not Header. Otherwise the token exchange will fail.
</Warning>

4. Click **Save** → **Connect my account**
5. Sign in to Minoa and authorize access

***

### Step 2: Use Minoa in Workflows

1. Create a new workflow with your preferred trigger
2. Add an **MCP Client** node
3. Select your Minoa MCP credential
4. Choose a tool (e.g., `list_business_cases` or `get_pipeline_analytics`)
5. Connect to other n8n nodes as needed

***

## Available Minoa Tools

| Tool                             | Description                                                          |
| -------------------------------- | -------------------------------------------------------------------- |
| `list_business_cases`            | Search and list business cases by name or status                     |
| `get_business_case`              | Get full details of a specific business case                         |
| `list_value_framework_use_cases` | List use cases from your value framework (compact: IDs, names, tags) |
| `get_value_framework_use_case`   | Get full detail for a single value framework use case                |
| `get_value_hypothesis`           | Get the AI-generated value hypothesis for a deal                     |
| `get_pipeline_analytics`         | Pipeline metrics, win rates, and trends                              |
| `get_use_case_analytics`         | Use case effectiveness and win rates                                 |
| `create_smart_business_case`     | Create a new business case with AI-recommended use cases             |

***

## Troubleshooting

### "OAuth Authorization Error" - Missing required parameters

**Cause**: Dynamic client registration failed because n8n looks for discovery endpoints at the root domain.

**Solution**: Disable "Use Dynamic Client Registration" and manually enter the Authorization URL and Access Token URL.

***

### "Missing or invalid required parameters" on token exchange

**Cause**: n8n is sending `client_id` in the HTTP header instead of the request body.

**Solution**: In the credential settings, set **Authentication** to **Body** (not Header).

***

## Need Help?

For access or other questions, reach out to [support@minoa.io](mailto:support@minoa.io).