# Getting Started with BrewLogica MCP

Last Updated: March 2026

This guide walks you through connecting BrewLogica to your AI assistant via MCP in under 5 minutes.

## Prerequisites

* A BrewLogica account (download on iOS)

* A Pro subscription (MCP API access requires Pro at $49.99/year)

* Node.js 18 or later installed

## Step 1: Create a BrewLogica Account

Download BrewLogica on iOS from the App Store and create an account.

* iOS: [https://apps.apple.com/app/brewlogica](https://apps.apple.com/app/brewlogica)


## Step 2: Generate an API Token

Visit [https://brewlogica.app/tokens](https://brewlogica.app/tokens) and sign in with your BrewLogica account. Click "Generate" to create a new token.

**Important:** Copy your token immediately. Tokens are only displayed once when created. Store it securely in a password manager. Tokens start with the `bl_` prefix.

## Step 3: Configure Your MCP Client

Replace `YOUR_TOKEN_HERE` with your actual token.

### Claude Code

Add to `~/.mcp.json` (global) or `.mcp.json` in your project root:

```json
{
  "mcpServers": {
    "brewlogica": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-remote",
        "https://api.brewlogica.app/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN_HERE"
      ]
    }
  }
}
```

### Claude Desktop

Edit your Claude Desktop configuration file:

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

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

```json
{
  "mcpServers": {
    "brewlogica": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-remote",
        "https://api.brewlogica.app/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN_HERE"
      ]
    }
  }
}
```

Restart Claude Desktop after saving.

### Cursor

Go to Settings → Features → MCP Servers and add the configuration above.

## Step 4: Test the Connection

After configuring your client, restart it and try:

* "What beans do I have in my collection?"

* "Show me my recent brews"

* "Log a new espresso: 18g in, 36g out, 28 seconds"

## Troubleshooting

**Connection refused**
Make sure your token is valid and hasn't been revoked. Check that you're using the correct API endpoint: `https://api.brewlogica.app/mcp`

**Authentication error**
Verify your token includes the `bl_` prefix and the full token string. Tokens are case-sensitive.

**MCP server not found**
Ensure Node.js is installed and you can run `npx` commands. The MCP remote proxy downloads automatically.

**"I can't connect to external services"**
The MCP server is not configured. Verify your `.mcp.json` exists in the correct location and restart your AI client.

## Related Documentation

* MCP Tools Reference: [https://brewlogica.app/docs/tools](https://brewlogica.app/docs/tools)

* MCP Quickstart: [https://brewlogica.app/docs/mcp-quickstart](https://brewlogica.app/docs/mcp-quickstart)

* Examples: [https://brewlogica.app/docs/examples](https://brewlogica.app/docs/examples)