Skip to main content
Glama
cphoskins

meetalfred-mcp

by cphoskins
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

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:

Layer

Auth

Required

Capabilities

Webhook API

MEETALFRED_API_KEY

Yes

Campaigns, leads, replies, connections, activity (read-heavy)

Internal API

MEETALFRED_JWT_TOKEN

No

Tags CRUD, campaign management, messaging, lead ops, post scheduling, notifications

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)

Tool

Description

get_campaigns

List campaigns by type (active, draft, archived, all)

get_leads

Fetch leads with campaign and person details

add_lead

Add a new lead to a campaign (LinkedIn URL required)

get_replies

Get reply messages from leads across campaigns

get_connections

Get LinkedIn connections with full profile data

get_team_members

List team members (requires team owner access)

get_member_connections

Get connections across team members

get_last_actions

Get recent activity by type (invites, accepted, messages, replies, etc.)

Internal API — Tags (requires MEETALFRED_JWT_TOKEN)

Tool

Description

get_all_tags

Get all tags (no pagination)

list_tags

List tags with pagination and sorting

create_tag

Create a new tag

update_tag

Rename an existing tag

delete_tag

Delete a tag

Internal API — Campaigns (requires MEETALFRED_JWT_TOKEN)

Tool

Description

list_campaigns_detailed

List campaigns with full details, stats, and filtering

get_campaign

Get full details of a single campaign

get_campaign_counts

Get campaign counts by status

get_campaigns_grouped

Get all campaigns grouped by category

update_campaign

Update campaign fields (name, status)

delete_campaign

Delete a campaign

pause_campaign

Pause a running campaign

resume_campaign

Resume a paused campaign

rename_campaign

Rename a campaign

clone_campaign

Clone (duplicate) a campaign

archive_campaign

Archive a campaign

Internal API — Messaging (requires MEETALFRED_JWT_TOKEN)

Tool

Description

list_replies_detailed

List replies with full details and sorting

get_conversation_messages

Get messages in a conversation thread

send_message

Send a message in a conversation (reply to a lead)

Internal API — Lead Management (requires MEETALFRED_JWT_TOKEN)

Tool

Description

get_campaign_leads

List leads in a campaign with status filtering

get_lead_statuses

Get lead status counts for a campaign

return_lead_to_campaign

Return leads to a campaign sequence

add_tags_to_leads

Add tags to one or more leads

exclude_leads

Exclude or un-exclude leads from campaigns

Internal API — Posts / Social Publishing (requires MEETALFRED_JWT_TOKEN)

Tool

Description

list_posts

List scheduled and published posts with engagement stats

get_post_types

Get post counts by platform (LinkedIn, Facebook, Instagram, Twitter)

get_post

Get full details of a single post (content, status, schedule, audience)

create_post

Create a new scheduled LinkedIn post (set title, content, time, audience)

update_post

Update a pending post's content, title, audience, or schedule

update_post_time

Reschedule a pending post to a new time

archive_post

Archive a post

delete_post

Delete a post

Internal API — Other (requires MEETALFRED_JWT_TOKEN)

Tool

Description

get_current_user

Get the current authenticated user's profile

get_unread_notification_count

Get count of unread notifications

Environment Variables

Variable

Required

Description

MEETALFRED_API_KEY

Yes

API key from Settings > Integrations > Webhooks

MEETALFRED_JWT_TOKEN

No

JWT token for internal API (enables tags, campaign CRUD, messaging, post scheduling)

MEETALFRED_BASE_URL

No

Override webhook API base URL for white-label instances

MEETALFRED_API_BASE_URL

No

Override internal API base URL for white-label instances

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

This server cannot be installed

A
license - permissive license
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
4dRelease cycle
4Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cphoskins/meetalfred-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server