meetalfred-mcp

MCP server for MeetAlfred — LinkedIn automation campaign monitoring, lead management, reply tracking, messaging, tag management, campaign CRUD, and social post scheduling.

Features

• Campaign monitoring — list, filter, pause/resume, rename, clone, archive campaigns
• Lead management — fetch leads, add to campaigns, tag, exclude, return to campaign
• Reply tracking — pull replies, view conversation threads, send messages
• Tag management — full CRUD on tags (create, list, update, delete)
• Lead tagging — add/set tags on individual leads or in bulk
• Social post scheduling — create, update, reschedule, archive, and delete LinkedIn posts
• Activity feed — review recent account actions across all channels
• Notifications — check unread count
• Team visibility — list team members and their connections
• User profile — get current authenticated user info
• White-label support — configurable base URLs for custom instances

Dual API Architecture

This server uses two MeetAlfred API layers:

The webhook API provides core read operations. The internal API (optional) enables full CRUD, messaging, and richer data. Both work simultaneously.

Installation

pip install meetalfred-mcp

Or install from source:

git clone https://github.com/cphoskins/meetalfred-mcp.git
cd meetalfred-mcp
pip install -e .

Configuration

Get your API key

1. Log in to MeetAlfred
2. Go to Settings > Integrations > Webhooks
3. Generate an API key

Get your JWT token (optional, for internal API)

1. Log in to MeetAlfred in your browser
2. Open DevTools > Application > Cookies
3. Copy the token cookie value

Claude Code

Add to your .claude/settings.json or project .mcp.json:

{
  "mcpServers": {
    "meetalfred": {
      "command": "meetalfred-mcp",
      "env": {
        "MEETALFRED_API_KEY": "your-api-key-here",
        "MEETALFRED_JWT_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

White-label instances

If you're using a white-label MeetAlfred instance, set the base URLs:

{
  "mcpServers": {
    "meetalfred": {
      "command": "meetalfred-mcp",
      "env": {
        "MEETALFRED_API_KEY": "your-api-key-here",
        "MEETALFRED_JWT_TOKEN": "your-jwt-token-here",
        "MEETALFRED_BASE_URL": "https://api.your-instance.com/api/integrations/webhook",
        "MEETALFRED_API_BASE_URL": "https://api.your-instance.com/api/v1"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "meetalfred": {
      "command": "python",
      "args": ["-m", "meetalfred_mcp.server"],
      "env": {
        "MEETALFRED_API_KEY": "your-api-key-here",
        "MEETALFRED_JWT_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Tools

Webhook API (requires MEETALFRED_API_KEY)

Internal API — Tags (requires MEETALFRED_JWT_TOKEN)

Internal API — Campaigns (requires MEETALFRED_JWT_TOKEN)

Internal API — Messaging (requires MEETALFRED_JWT_TOKEN)

Internal API — Lead Management (requires MEETALFRED_JWT_TOKEN)

Internal API — Posts / Social Publishing (requires MEETALFRED_JWT_TOKEN)

Internal API — Other (requires MEETALFRED_JWT_TOKEN)

Environment Variables

Common Workflows

Reply to a lead

1. list_replies_detailed() → find reply with conversationUrn
2. get_conversation_messages(conversationUrn) → read conversation history
3. send_message(conversationUrn, "Your reply text")

Return a lead to a campaign

1. get_campaign_leads(campaignId, "replied") → find lead entityUrn
2. return_lead_to_campaign([entityUrn], campaignId)

Schedule a LinkedIn post

1. create_post(title="Internal label", content="Post body text", scheduled_at="2026-03-15T14:00:00.000Z")
2. list_posts() → verify post was created, get post ID
3. update_post_time(postId, "2026-03-16T15:00:00.000Z") → reschedule if needed

Tag leads from a campaign

1. get_all_tags() → find or create tag IDs
2. get_campaign_leads(campaignId) → get entity URNs
3. add_tags_to_leads([entityUrns], [tagIds])

Development

git clone https://github.com/cphoskins/meetalfred-mcp.git
cd meetalfred-mcp
pip install -e ".[dev]"
pytest tests/

License

MIT