Getting Started

1. Create a BrewLogica Account

Before using the MCP integration, you need a BrewLogica account. You can create one by downloading the app on iOS or Android.

2. Generate an API Token

Visit the API Tokens page and sign in with your BrewLogica account. Click "Generate" to create a new token.

Important: Copy your token immediately!

For security, tokens are only displayed once when created. Store it securely.

3. Configure Your MCP Client

Claude Code

Add the following to your .mcp.json file in your project or home directory:

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

Claude Desktop

Add to your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "brewlogica": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-remote",
        "https://api.brewlogica.app/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN_HERE"
      ]
    }
  }
}

Cursor

Cursor supports MCP via its settings. Go to Settings → Features → MCP Servers and add the configuration above.

4. Test the Connection

After configuring your client, restart it and try asking about your coffee data:

"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 you have Node.js installed and can run npx commands. The MCP remote proxy will be downloaded automatically.