Minnal Documentation

Minnal is an AI-native marketing platform. You plan, create, and publish content across social platforms by talking to Claude.

Overview

Minnal connects to Claude via the Model Context Protocol (MCP), giving Claude the tools to schedule posts, check AI visibility, analyze competitor content, and publish across LinkedIn, Facebook, Instagram, and Reddit — all through natural conversation.

Setup

1. Create an account at app.minnal.io
2. Create a project for your brand
3. Connect your social platforms in Integrations
4. Copy your MCP config from Settings and add it to Claude Desktop

Claude MCP

Step 1 — Install Node.js (if you haven’t already)

Go to nodejs.org, download the LTS version, and run the installer. You won’t need to do anything with it — Minnal just needs it in the background.

Step 2 — Get your config from Minnal

Log into app.minnal.io → Settings → copy the MCP config block. It looks like this:

{
  "mcpServers": {
    "minnal": {
      "command": "npx",
      "args": ["minnal-mcp@latest"],
      "env": {
        "MINNAL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Step 3 — Paste it into Claude Desktop

Open Claude Desktop, then go to Settings → Developer → Edit Config. This opens the config file directly. Paste the block in and save.

If you can’t find it, the file is here:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: Open File Explorer, type %APPDATA%\Claude in the address bar, open claude_desktop_config.json

If the file already has other MCP servers in it, paste just the "minnal": { ... } part inside the existing "mcpServers" block — don’t replace the whole file.

Step 4 — Restart Claude Desktop

Fully quit and reopen Claude Desktop (don’t just close the window). Open a new conversation — you should see a 🔧 tools icon. That means Minnal is connected.

Claude Project

A Claude Project gives Claude persistent memory about your brand. Without it, every conversation starts fresh.

1. In Claude Desktop, click Projects → New Project
2. Name it after your brand
3. Add project instructions — brand name, what you do, tone of voice, target audience, platforms, subreddits

The more specific your instructions, the more on-brand the output.

AI Visibility

Queries Claude, ChatGPT, Perplexity, Gemini, and Grok with your brand keywords. Scores each response 0–100 based on how prominently your brand appears.

• 0–30 — not mentioned or very weak
• 31–60 — mentioned but not prominently
• 61–100 — strong, prominent mention

Run checks from the GEO tab inside your project.

Content Signals

Analyzes competitor URLs you add in project settings and identifies topics they cover that you don’t. Click Analyze to run a fresh AI-powered analysis. Results include topic gaps and suggested post angles.

GEO Playbook

Prioritized actions to improve how AI models find and cite your brand — comparison posts, Reddit threads, FAQ pages, Wikipedia presence, and citation outreach. Each tactic includes a ready-to-use Claude prompt in the right column.

Scheduling

Ask Claude to schedule or publish posts:

“Schedule a LinkedIn post about our new feature for next Tuesday at 9am.”

Claude drafts the content, queues it in Minnal, and confirms the time. Check the Scheduled tab to review, edit, or cancel before it publishes.

Integrations

Blog (GitHub Pages)

Publish blog posts directly to your GitHub Pages site as markdown files. Supports Jekyll, Hugo, Astro, and custom frontmatter.

1. Create a GitHub Personal Access Token with repo scope
2. In project Settings → Integrations → GitHub Pages, enter your PAT, repo (owner/repo), branch, posts folder, and site type
3. Ask Claude: “Write a blog post about [topic] and publish it to our blog”

Claude commits the markdown file directly to your repo. GitHub Pages builds it automatically.

Knowledge Sources

Connect a Notion workspace so Claude can reference your existing documents when writing content. Add via Settings → Knowledge Sources.