---
updatedAt: 2026-07-21T06:57:58.000Z
agentTools:
  projectIndex: https://developers.fireberry.com/llms.txt
---

# Fireberry API MCP

Connect your AI assistants directly to Fireberry CRM for seamless, natural language CRM operations. The Fireberry MCP (Model Context Protocol) server enables Claude, Cursor, VS Code, and other AI tools to interact with your CRM data through conversational commands.

> 📘 **What is MCP?**
>
> MCP (Model Context Protocol) is a standard that allows large language models (LLMs) to perform actions on behalf of users. It connects AI assistants to external systems like your CRM.

## What You Can Do

<Cards columns={2}>
  <Card title="Explore CRM Structure" icon="fa-sitemap">
    List objects, fields, and picklist values using natural language
  </Card>

<Card title="Create & Customize" icon="fa-plus-circle">
    Add new objects and fields to extend your CRM schema
</Card>

  <Card title="Manage Records" icon="fa-database">
    Create and update any CRM records through AI conversation
  </Card>

  <Card title="Query & Aggregate" icon="fa-chart-bar">
    Filter, sort, and aggregate CRM records (SUM, COUNT, MIN, MAX) using natural language
  </Card>
</Cards>

## Quick Start

### Prerequisites

Before getting started, you'll need:

* **Node.js v18+** and **NPM v10.8.2+**
* A **Fireberry CRM account** with API access
* Your **Fireberry API token** ([get one here](https://fireberry.readme.io/docs/authentication))

## Installation & Setup

The instructions below guides how to integrate with tested clients, yet it may and should work in other clients.

<Tabs>
  <Tab title="Claude Desktop (Recommended)">
    
**Step 1: Locate Configuration File**

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

**Step 2: Add MCP Configuration**

```json
{
    "mcpServers": {
        "fireberry-crm": {
            "command": "npx",
            "args": ["-y", "@fireberry/mcp-server@latest"],
            "env": {
                "FIREBERRY_TOKEN_ID": "<your-fireberry-api-token-here>"
            }
        }
    }
}
```

**Step 3: Restart Claude Desktop**

  <Image align="left" border={false} caption="Restart Claude Desktop by simply closing the app and opening it again, or click Developer → Reload MCP Configuration" src="https://files.readme.io/feeea1a15b831f449949193617aa8158dfa3488ade42bfe333046c6f6691aae8-image.png" width="550px" />

  </Tab>

  <Tab title="Cursor IDE">
Click this link to easily install the MCP server:

[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=fireberry-crm&config=eyJjb21tYW5kIjoibnB4IC15IEBmaXJlYmVycnkvbWNwLXNlcnZlciIsInR5cGUiOiJzdGRpbyIsImVudiI6eyJGSVJFQkVSUllfVE9LRU5fSUQiOiIifX0%3D)
<Image align="left" border={false} caption="Enter the token after clicking the quick installation button then hit install" src="https://files.readme.io/3407b1da5ad5c699774816f5f3e6c585f371e105c79fff9c76a5762e41422380-image.png" width="600px" />

or follow the steps below:

1. Open Cursor Settings
2. Navigate to **"Tools & Integrations"** → **"MCP Servers"**
3. Click **"New MCP Server"**

```json
{
    "fireberry-crm": {
        "command": "npx",
        "args": ["-y", "@fireberry/mcp-server@latest"],
        "env": {
            "FIREBERRY_TOKEN_ID": "<your-fireberry-api-token-here>"
        }
    }
}
```

<Image align="left" border={false} caption="Enable the new MCP" src="https://files.readme.io/1f9494ea9471756617b518f8e1ef4fd8a0022665455a33c41b4d1d3a4cc2f80a-Screenshot_2025-08-26_at_18.52.53.png" width="300px" />

<Image align="left" border={false} caption="You should see the tools enabled and the server activated" src="https://files.readme.io/93f6650231a3425651c923803f2af8e16c7bdfeeca7e8ede4c370cbcc883133d-Screenshot_2025-08-26_at_19.04.11.png" />


  </Tab>
</Tabs>

> 🚧
>
> Please [submit a ticket](https://www.fireberry.com/submit-ticket) or [report an issue](https://github.com/fireberry-crm/mcp-server/issues) if your client was not supported by our server and we will do our best to address it.

<Accordion title="Alternative JavaScript Runtimes" icon="fa-cogs">

If you prefer different JavaScript runtimes:

<Tabs>
  <Tab title="Bun">
      
  **Using Bun:**
  
  ```json
  {
      "mcpServers": {
          "fireberry-crm": {
              "command": "bunx",
              "args": ["--bun", "@fireberry/mcp-server@latest"],
              "env": {
                  "FIREBERRY_TOKEN_ID": "<your-fireberry-api-token-here>"
              }
          }
      }
  }
  ```
  </Tab>
  
  <Tab title="Deno">
  
  **Using Deno:**
  
  ```json
  {
      "mcpServers": {
          "fireberry-crm": {
              "command": "deno",
              "args": ["run", "--allow-read", "--allow-net", "--allow-env", "npm:@fireberry/mcp-server@latest"],
              "env": {
                  "FIREBERRY_TOKEN_ID": "<your-fireberry-api-token-here>"
              }
          }
      }
  }
  ```
  </Tab>
</Tabs>

</Accordion>

## Testing Your Setup

Once configured, test your connection with these prompts:

<Cards columns={2}>
  <Card title="Explore Structure" icon="fa-search">
    "What CRM objects are available in Fireberry?"
    
    "Show me fields for the Contacts object"
  </Card>

  <Card title="Create & Manage" icon="fa-edit">
    "Create a custom Projects object"
    
    "Add a new contact named John Smith"
  </Card>
</Cards>

## Usage Examples

### Natural Language Commands

<Accordion title="Exploring Your CRM" icon="fa-compass">

**Discover available objects:**

```
"What object types are available in my Fireberry CRM?"
"List all the custom objects I've created"
```

**Examine object structure:**

```
"Show me all fields for the Contacts object"
"What are the picklist values for Account Status?"
```

</Accordion>

<Accordion title="Creating Custom Objects & Fields" icon="fa-plus-square">

**Create new objects:**

```
"Create a new custom object called 'Projects' with description and status fields"
"Add a 'Vendors' object with company name, contact info, and rating fields"
```

**Add custom fields:**

```
"Add a 'Project Budget' currency field to the Projects object"
"Create a Priority picklist field with High, Medium, Low options"
"Add a lookup field linking Projects to Contacts"
```

</Accordion>

<Accordion title="Managing Records" icon="fa-database">

**Create records:**

```
"Create a new contact named Sarah Johnson with email sarah@company.com"
"Add a new project called 'Website Redesign' with high priority"
```

**Update existing records:**

```
"Update John Smith's phone number to +1-555-0123"
"Change the 'Website Redesign' project status to 'In Progress'"
```

**Bulk operations:**

```
"Import this contacts CSV file into my CRM"
"Create multiple accounts from the attached spreadsheet"
```

</Accordion>

<Accordion title="Querying & Aggregating Data" icon="fa-magnifying-glass-chart">

**Filter and sort records:**

```
"Show me all accounts created in the last 30 days, sorted by name"
"Find contacts where email starts with 'john' and status is active"
"List the 10 most recent opportunities for the Northeast region"
```

**Aggregate with groupBy:**

```
"Count opportunities grouped by status"
"What's the total revenue per account owner this quarter?"
"Show me the average deal size by industry, only for closed deals"
```

**Group by time period:**

When grouping on a date or datetime field, the query tool can bucket records into time periods — by hour, day, week, month, quarter, year, or recurring slots like hour-of-day, day-of-month, week/month/quarter-of-year, and day-of-week. This makes time-based trend and seasonal analysis effortless.

```
"Count new accounts per month this year"
"Show total revenue by quarter"
"How many cases are opened by day of the week?"
```

**Relative date filters:**

The query tool understands relative date tokens like `today`, `last-week`, `last-30-days`, `this-quarterly`, `last-12-months`, and many more — no need to compute ISO dates yourself.

> 📘 Full query reference
>
> The query tool is powered by the v3 query endpoint. For the complete list of operators, relative date tokens, `datePeriod` values, and aggregation rules, see the [Queries (v3)](https://developers.fireberry.com/docs/queries-v3#date-period) guide.

</Accordion>

## Security & Best Practices

<Columns layout="auto">
    <Column>
        ### 🔐 Security 
        - HTTPS encryption for all requests
        - Token validation on startup
    </Column>
    <Column>
        ### 📋 Best Practices
         - Start with exploration before creating
         - Use descriptive names for objects/fields
         - Test with small data sets first
         - Plan relationships before creating lookups
    </Column>
</Columns>

## Troubleshooting

<Accordion title="Server Not Starting" icon="fa-exclamation-triangle">

**Common causes:**

- Invalid or expired API token
- Node.js not installed or outdated
- Network connectivity issues

**Solutions:**

1. Verify your `FIREBERRY_TOKEN_ID` is correct
2. Check Node.js version: `node --version` (requires v18+)
3. Test manual connection: `npx -y @fireberry/mcp-server@latest`
4. Check network access to `api.fireberry.com`

</Accordion>

<Accordion title="Tools Not Appearing" icon="fa-tools">

**If Fireberry tools don't show up in your AI client:**

1. **Restart your AI assistant** after configuration changes
2. **Check JSON syntax** in configuration files
3. **Look for error messages** in your client's console/logs


</Accordion>

<Accordion title="Authentication Errors" icon="fa-lock">

**"Invalid token" or similar errors:**

1. **Check token permissions** - ensure API access is enabled
2. **Verify environment variable** name: `FIREBERRY_TOKEN_ID`
3. **Remove extra spaces** from token value

</Accordion>

## Support & Resources

<Cards columns={2}>
    <Card title="Documentation" href="https://developers.fireberry.com/" icon="fa-book" target="_blank">
        Complete API reference and guides
    </Card>

    <Card title="GitHub Issues" href="https://github.com/fireberry-crm/mcp-server/issues" icon="fa-bug-slash" target="_blank">
        Report bugs and request features
    </Card>
</Cards>

***

**Need help?** Contact our support team through your Fireberry CRM dashboard or visit [fireberry.com/support](https://fireberry.com/support).