Projects
Manage all your marketing brands and accounts
Scheduled Posts
All queued content across your projects
Integrations
Connect your platforms and tools

Connect Claude Desktop

REQUIRED FIRST

Minnal runs inside Claude Desktop via MCP. Follow these 3 steps once to connect, then talk to Claude to schedule posts, pull analytics, and plan content.

1
Install Node.js

Minnal's MCP client runs via npx, which comes bundled with Node.js.

Install Node.js Already installed? Skip to Step 2.
2
Find your Claude Desktop config file

Easiest: In Claude Desktop, open Settings → Developer → Edit Config. This opens the folder containing claude_desktop_config.json.

Or open the file manually:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

If the file doesn't exist yet, create it as an empty file.

3
Copy & paste your MCP config

Your API key is already included below — just copy the whole block and paste it into the config file. Save, then quit and reopen Claude Desktop.

✓ Done! After pasting, quit and reopen Claude Desktop. You should see Minnal tools available in a new conversation.

Social platforms connect per project. Open any project → Overview tab → click Connect next to LinkedIn, Facebook, or Instagram. Each project gets its own authorization so you can use different accounts per brand.

Help & Tips
Getting the most out of Minnal with Claude

Quick Setup

  1. Install Node.js — required to run the MCP client via npx
  2. Copy the MCP config from and paste it into your Claude Desktop config file
  3. Set up a Claude Project — in Claude Desktop, create a Project for your brand and paste in your brand voice, target audiences, and product description. This is the most important step for content quality.
  4. Connect your social platforms in
  5. Ask Claude: "Plan this week's content for [your brand]" and start scheduling

Using Claude Effectively

✅ Do this
  • Be specific — platform, brand, timing, tone:
    "Schedule 3 LinkedIn posts for Flow next week targeting ADHD founders, keep the tone personal"
  • Set up a Claude Project with your brand voice, audiences, and product info — Claude generates generic content without it
  • Ask for a weekly plan first, then approve individual posts
  • Tell Claude what performed well: "That story format got 3× engagement — write more like that"
  • Check the queue in Scheduled before posts go live
❌ Don't do this
  • Say "do my marketing" — Claude can't write on-brand content without context
  • Skip the Claude Project setup — posts will be generic without brand context
  • Schedule before connecting a platform in Integrations — posts will fail
  • Forget to set target audiences in your project settings
  • Use Minnal without Claude Desktop configured — check Settings first
💡 Pro tip: In Claude Desktop, create a Project (not just a chat) and add your brand voice, competitor analysis, and product description as project instructions. Everything you ask Claude will be dramatically more on-brand.

Full Documentation

Step-by-step setup guides, advanced workflows, and example prompts.

Read the full guide →
Account
Manage your profile, security, and data

Profile

Email
Member since
Password

Email changes aren't available yet — they'll be enabled once account verification is in place.

API key

Your API key authenticates Claude Desktop and any custom integrations. If it's ever exposed, regenerate it immediately — the old key will stop working and you'll need to update your Claude Desktop config (Settings tab).

Export my data

Download a JSON file containing every row Minnal stores for your account — user info, brands, scheduled posts, engagement metrics, connected credential metadata (not the encrypted tokens), and knowledge sources. Use this to keep a personal backup or migrate to another platform.

Delete my account

Permanently delete your account and all associated data: brands, scheduled posts, engagement metrics, connected credentials, knowledge sources, and AI visibility history.

This action cannot be undone. Consider exporting your data first.

Admin
Test API key connections and diagnose configuration issues

Connection Tests

Tests each API key with a minimal request. Keys are read from server environment variables — set them in Railway.

Click Run tests to check all connections.

Database Migrations

Run pending schema migrations on the Supabase database. Each migration is idempotent — safe to run more than once.

add_webhooks
ALTER TABLE brands ADD COLUMN IF NOT EXISTS webhooks JSONB DEFAULT '[]'