Meta MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Meta MCP ServerPost our holiday hours to our Facebook page"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Why This Exists
Social media management across Meta's platforms — Facebook Pages, Instagram, Threads, Ads Manager, Commerce — requires juggling multiple dashboards, each with its own API quirks and token flows. This server consolidates the entire Meta Graph API surface into a single MCP interface, so your AI assistant can publish content, analyze performance, manage ad campaigns, and moderate engagement across all platforms in one conversation.
Every tool returns actionable error messages — not cryptic API codes. Token expired? You get a regeneration link. Missing permission? You see exactly which one and where to grant it. This means less debugging and more doing.
Quick Start
Install with MCPB
For Claude Desktop and other MCPB-compatible clients, download the local bundle from the v2.0.2 release:
Download meta-mcp-server-2.0.2.mcpb
The bundle includes the Meta favicon, production runtime dependencies, and setup prompts for Meta and optional Threads access tokens.
Add to your MCP client config:
{
"mcpServers": {
"meta": {
"command": "npx",
"args": ["-y", "@oliverames/meta-mcp-server"],
"env": {
"META_ACCESS_TOKEN": "your_token_here"
}
}
}
}That's it. Your AI assistant now has access to 200 Meta tools.
Need a token? Go to the Graph API Explorer, select your app, and generate one. See Configuration for details.
From Source
git clone https://github.com/oliverames/meta-mcp-server.git
cd meta-mcp-server
npm install && npm run buildWhat You Can Do
Publish everywhere
Post to Facebook Pages (text, photo, video, Reels, Stories), Instagram (photos, reels, stories, carousels), and Threads (text, images, video, GIFs, links). Schedule content in advance or cross-post to multiple platforms in one call.
> Post our holiday hours to the Facebook page
> Schedule an Instagram carousel for tomorrow at 9am
> Cross-post this photo to both Facebook and Instagram
> Publish a GIF to Threads with reply controls
> Create a Facebook Reel from this video
> Post a Story to our Facebook page
> Publish an Instagram reel with alt text for accessibility
> Share a link post on Threads with a quoteManage engagement
Read and reply to comments across platforms, hide inappropriate content without deleting it, manage Instagram DMs and broadcast channels, and set up automated responses for when you're away.
> Show me unanswered Instagram DMs
> Hide that offensive comment on our latest post
> Reply to the top 3 comments on yesterday's reel
> Set up an instant reply for new messages
> Set our away message to "Back Monday at 9am"
> Send a DM to that customer who reached out
> What comments did we get on last week's posts?
> Update our Messenger greeting textAnalyze performance
Get insights at every level — page, post, account, campaign, ad set, and individual ad. Over 70 page metrics, comprehensive Reels analytics (including skip rate and crossposted views), and full ad performance with video completion rates, ROAS, and quality rankings. Generate charts for reports.
> How did our Instagram perform this month?
> Show campaign spend broken down by age group
> What's the skip rate on our latest Reel?
> Generate a bar chart comparing this week vs last
> Get our Facebook page fan demographics
> What's our follower growth trend over 90 days?
> Show me post-level engagement for our top 5 posts
> Create a pie chart of spend by campaignRun ad campaigns
Full campaign lifecycle — create, optimize, test, and automate. A/B testing with confidence levels, Advantage+ Shopping migration, interest/geo/demographic targeting search, reach estimates, automated rules, and comprehensive pixel management with server-side Conversions API.
> Create an A/B test comparing these two ad sets
> Migrate this campaign to Advantage+ Shopping
> Send a purchase conversion event via CAPI
> What's the reach estimate for women 25-34 in NYC?
> List all active campaigns and their ROAS
> Create an automated rule: pause ads over $5 CPA
> Check if our pixel is firing correctly
> Upload this image for a new ad creativeManage commerce
Full product catalog management for Facebook and Instagram shops — add products, update inventory, organize collections, and manage availability. Everything a brand needs to run social commerce.
> List all products in our catalog
> Add this new product at $29.99, in stock
> Mark the seasonal items as out of stock
> Show me our "Summer Collection" product set
> Update the description on our best-selling item
> How many products are in each catalog?
> Delete the discontinued product line
> What products are currently available?Go live and broadcast
Start Facebook Live video broadcasts for product launches and events, publish Stories for time-sensitive content, and reach your audience directly through Instagram broadcast channels with polls, links, and messages.
> Start a live video on our Facebook page
> Send a poll to our Instagram broadcast channel
> Schedule a live stream for Friday at 2pm
> Publish a story to Facebook with this photo
> End the live broadcast
> Send a product announcement to our broadcast channel
> What live videos have we done this month?
> What ads is our competitor running right now?Research competitors
Search any advertiser's active ads through Meta's public Ad Library. See what creative, targeting, and spend your competitors are using — no account access needed. Look up any public Instagram business account's stats.
> What ads is Nike running in the US right now?
> Search the Ad Library for "sustainable fashion" ads
> Look up @competitor on Instagram — followers and posts
> Show me all active ads by this page ID
> What platforms are they running ads on?
> How much is our competitor spending on ads?Stay in control
Debug tokens, check permissions, monitor rate limits, verify pixel health, and manage your Business Manager assets. Every error tells you exactly what went wrong and how to fix it — never a cryptic failure.
> Check my token status and permissions
> Am I close to Instagram's publishing limit?
> Run a health check on the Meta connection
> Is our pixel receiving events?
> List all ad accounts in our Business Manager
> Share this pixel with our agency's ad account
> What Threads rate limits do we have left?
> Debug why this API call is failingComplete Tool Reference
Facebook Pages — 52 tools
Everything a brand needs to manage their Facebook presence, messaging, and live broadcasts.
Tool | Description |
| List all Facebook Pages you manage (call first — caches page tokens) |
| Get detailed page info (category, followers, description, links) |
| Get a single post by ID |
| Create a text post on a page |
| Create a photo post (URL or page photo ID) |
| Create a video post with optional title and description |
| Edit an existing post's message |
| Delete a post |
| Get a page's feed with pagination |
| Get published posts only |
| Get scheduled (unpublished) posts |
| Get posts eligible for ad promotion |
| Get posts made by visitors on the page |
| Get comments on a post with pagination |
| Reply to a comment as the page |
| Delete a comment |
| Hide or unhide a comment (non-destructive moderation) |
| Like or unlike a post or comment |
| Get reaction breakdown (like, love, haha, wow, sad, angry) |
| Page analytics — 70+ metrics across impressions, engagement, fans, video |
| Per-post analytics (impressions, engagement, clicks, reactions, video) |
| List page message conversations |
| Get messages within a conversation |
| Send a message to a user (24-hour messaging window) |
| Update page details (about, description, website, hours, username, category, address) |
| Update page profile picture from URL |
| Update page cover photo from URL or existing photo |
| Create a page event |
| List events (upcoming, past, or canceled) |
| List page photo albums |
| Get photos (uploaded or tagged) |
| List page videos |
| Get posts where the page is tagged |
| Follower breakdown by age, gender, and country |
| Get page reviews and star ratings |
| Location info for multi-location businesses |
| Get the page's call-to-action button configuration |
| List page tabs and their configuration |
| Get page profile picture URL |
| List blocked users |
| Block or unblock a user |
| Subscribe the page to webhook events |
| Publish a Facebook Story (photo or video) |
| Publish a Facebook Reel |
| Cross-post to Facebook + Instagram simultaneously |
| Start or schedule a live video broadcast |
| List live videos on a page |
| End an active live broadcast |
| Get current auto-reply settings |
| Set the instant reply message |
| Set the away/out-of-office message |
| Set the Messenger greeting text |
Instagram — 37 tools
Full Instagram Business API — publishing with scheduling, DMs, broadcast channels, engagement, discovery, and analytics.
Tool | Description |
| List Instagram business accounts linked to your Facebook Pages |
| Get recent media for an Instagram account with pagination |
| Get a single media object by ID |
| Publish a photo with optional alt text and scheduling |
| Publish a reel with auto-polling and optional scheduling |
| Publish a story (image or video with auto-polling) |
| Publish a carousel (2–10 items, parallel processing, schedulable) |
| Publish a pre-created media container |
| Check container processing status with actionable messages |
| Account-level analytics with demographic breakdowns |
| Per-post metrics including Reels skip rate, crossposted views |
| Get comments on a media object |
| Get threaded replies to a comment |
| Reply to a comment |
| Delete a comment |
| Hide/unhide a comment (non-destructive moderation) |
| Search for products in an Instagram Shopping catalog by name |
| Search hashtag top or recent media |
| Get your recently searched hashtags |
| Business discovery — look up any public business/creator by username |
| Get currently active stories |
| Get live video media |
| Get media where you're @mentioned |
| Get individual items in a carousel |
| Get product tags on a media object |
| Delete a media object |
| Enable or disable comments on media |
| Check rate limit status (100 posts per 24 hours) |
| List Instagram DM conversations |
| Get messages in a DM conversation |
| Send a text DM |
| Send an image or link via DM |
| List product catalogs available for Instagram Shopping on a professional account |
| List broadcast channels |
| Get messages in a broadcast channel |
| Send a message to a broadcast channel |
| Create a poll in a broadcast channel |
Ads Manager — 62 tools
Complete ad campaign lifecycle — create, optimize, test, analyze, and automate. Includes Advantage+ migration, A/B testing, and comprehensive pixel management.
Tool | Description |
| List ad accounts you have access to |
| Get ad account details (status, currency, spend cap, balance) |
| List campaigns with status filtering and pagination |
| Get a single campaign's full details |
| Create a campaign (supports Advantage+ Shopping for OUTCOME_SALES) |
| Update campaign name, status, budget, or migrate to Advantage+ |
| Delete a campaign |
| Migrate a campaign to Advantage+ Shopping (keeps campaign ID) |
| List ad sets with filtering |
| Get a single ad set's targeting and budget details |
| Create an ad set with targeting, budget, and placement_soft_opt_out |
| Update ad set targeting, budget, or placement_soft_opt_out |
| Delete an ad set |
| List ads with status filtering |
| Get a single ad's details |
| Create an ad linking a creative to an ad set |
| Update ad name, status, or creative |
| Delete an ad |
| List ad creatives |
| Get a single creative's details |
| Create an ad creative with text, image, and link |
| Preview how an ad will appear in different placements |
| Get details for a specific automated ad rule |
| List users with access to the ad account |
| Upload an image for use in ad creatives |
| List previously uploaded ad images |
| Upload a video for use in ad creatives |
| List previously uploaded ad videos |
| Search for interest-based targeting options |
| Search for location-based targeting (countries, cities, zips) |
| Search for demographic targeting options |
| Browse all available targeting categories |
| Estimate potential audience size for a targeting spec |
| Estimate ad delivery for a given budget and targeting |
| Get submitted leads from a lead generation form |
| Get minimum daily and lifetime budgets for an ad account by currency and bid strategy |
| List lead generation forms for a Facebook Page |
| List offline conversion event sets for an ad account |
| List Meta Pixels for conversion tracking |
| Create a new pixel |
| Get pixel details (name, cookie status, matching fields) |
| Get event volume stats over time (verify pixel is firing) |
| Update pixel settings (name, cookies, matching, data use) |
| Delete a pixel |
| Share pixel access with another ad account |
| Get recent test events for debugging |
| List custom conversion events |
| Create a custom conversion from pixel events |
| List saved audiences |
| Create a reusable saved audience |
| Delete a saved audience |
| List automated ad rules |
| Create an automated rule (e.g., pause ads over $5 CPA) |
| Delete an automated rule |
| List ad labels for organization |
| Create an ad label |
| Get the ad account's activity log |
| List pages, ad accounts, IG accounts, and pixels across Business Manager |
| Create an A/B test to compare campaigns or ad sets |
| List A/B tests for an ad account |
| Get A/B test results with winner and confidence level |
| Send an offline conversion event for in-store purchases, phone orders, or other offline conversions |
Threads — 22 tools
Full Threads API — publishing with GIFs, reply controls, location tagging, and analytics.
Tool | Description |
| Get your Threads profile info |
| Get your recent posts with pagination |
| Get a single post by ID (includes reply_audience) |
| Search your posts by keyword |
| Publish a text post (with reply control and location) |
| Publish an image post (with reply control and location) |
| Publish a video post with auto-polling (with reply control and location) |
| Publish a carousel (parallel creation, with reply control) |
| Publish a post with a link attachment (with reply control) |
| Publish a GIF post via GIPHY URL |
| Delete a post |
| Get replies to a post |
| Get the full conversation tree for a post |
| List followers of the authenticated Threads user |
| List accounts the authenticated Threads user is following |
| Get posts that @mention you |
| Get individual items in a carousel post |
| Hide or unhide a reply |
| Repost a Threads post |
| Get metrics for a specific post (views, likes, replies, etc.) |
| Get account-level metrics with demographic breakdowns |
| Check your current publishing rate limit status |
Commerce — 10 tools
Product catalog management for Facebook and Instagram shops.
Tool | Description |
| List product catalogs for a business |
| Get catalog details and product count |
| List products in a catalog with filtering |
| Get a single product's full details |
| Add a product to a catalog |
| Create a product feed to automatically sync products from a URL |
| Update product details (name, price, availability, etc.) |
| Delete a product from a catalog |
| List product feeds for a catalog |
| List product sets (subgroups) in a catalog |
Conversions API — 2 tools
Server-side event tracking for conversion optimization.
Tool | Description |
| Send a server-side conversion event (Purchase, Lead, etc.) to a pixel |
| Test CAPI setup without affecting production data |
Audiences — 5 tools
Custom and lookalike audience management for ad targeting.
Tool | Description |
| List custom audiences in an ad account |
| Get audience details (size, delivery status) |
| Create a custom audience |
| Create a lookalike audience from a source audience |
| Delete a custom audience |
Insights — 4 tools
Performance analytics across the ad hierarchy with 37 metrics, 15 date presets, and 8 breakdown dimensions.
Tool | Description |
| Ad account performance — spend, impressions, reach, clicks, CTR, CPM, CPC, conversions, ROAS, video completion, quality rankings |
| Per-campaign performance with the same comprehensive metrics |
| Per-ad-set performance |
| Per-ad performance |
Charts — 2 tools
Generate visual charts from data for reports and presentations.
Tool | Description |
| Create bar, line, pie, doughnut, radar charts as PNG images |
| Generate side-by-side comparison charts (A/B, period-over-period) |
Ad Library & Utility — 4 tools
Tool | Description |
| Search any advertiser's active ads — public transparency API |
| Inspect your token: type, validity, expiry, permissions, associated app and user |
| Check server health: token status, cached tokens, API connectivity |
| Search Facebook Places (locations) by name or coordinates for post tagging |
Configuration
Variable | Required | Default | Description |
| Yes | None | Long-lived Meta Graph API token for Facebook Pages, Instagram, Ads Manager, Commerce, Conversions API, Audiences, Insights, and utility tools. |
| No | None | Threads API token. Required only for Threads publishing, replies, and insights tools. |
1. Create a Meta App
Go to developers.facebook.com → My Apps → Create App → choose Business type. Add Facebook Login, Pages API, Instagram Graph API, and Marketing API.
2. Generate Tokens
Get a token from the Graph API Explorer, then exchange it for a long-lived token (60 days):
curl "https://graph.facebook.com/oauth/access_token?\
grant_type=fb_exchange_token&\
client_id=YOUR_APP_ID&\
client_secret=YOUR_APP_SECRET&\
fb_exchange_token=SHORT_LIVED_TOKEN"For permanent access, create a System User token in Business Manager → System Users.
Threads uses a separate token via graph.threads.net OAuth — see Threads API docs.
1Password Integration
If META_ACCESS_TOKEN or THREADS_ACCESS_TOKEN are not set in the environment, the server automatically attempts to resolve them from 1Password CLI:
op://Development/Meta Access Token/credential
op://Development/Threads Access Token/credentialThis means you can skip setting env vars entirely if you have op installed and a service account or session active. The fallback adds ~1-2s to startup per token and is silently skipped if 1Password is unavailable.
3. Grant Permissions
Permission | Required for |
| Listing pages |
| Page insights, reactions |
| Creating, editing, deleting posts |
| Page settings, webhooks, profile picture, cover photo |
| Tagged posts, visitor posts, ratings |
| Reading and sending messages, automated responses |
| Instagram account info |
| Publishing photos, reels, stories, carousels |
| Instagram analytics |
| Comment management |
| Instagram DMs |
| Reading campaigns, ad sets, ads, insights |
| Creating and managing ads, A/B tests |
| Business Manager assets, product catalogs |
| Product catalog CRUD |
| Threads profile and posts |
| Publishing to Threads |
| Threads analytics |
| Managing Threads replies |
4. Connect to Your MCP Client
Claude Code — add to ~/.claude/settings.json:
{
"mcpServers": {
"meta": {
"command": "node",
"args": ["/absolute/path/to/meta-mcp-server/dist/index.js"],
"env": {
"META_ACCESS_TOKEN": "your_long_lived_token",
"THREADS_ACCESS_TOKEN": "your_threads_token"
}
}
}
}Works with any MCP client that supports stdio transport. THREADS_ACCESS_TOKEN is optional — only needed for Threads tools.
How It Works
The server starts without any tokens configured — no crashes, no "failed" status in MCP settings. When you call a tool without proper auth, you get a clear setup message.
First call should always be meta_list_pages — this caches the page-scoped access tokens required for all Page and Instagram operations.
Error Handling
Every error message tells you what went wrong, why, and how to fix it:
What happened | What you see |
No token set | Step-by-step setup instructions with link to Graph Explorer |
Token expired (code 190) | Direct link to regenerate at developers.facebook.com |
Missing permission (code 10/200) | Names the exact permission needed and where to grant it |
Rate limited (429) | Tells you to wait, links to Meta's rate limit docs |
Page token missing | Reminds you to call |
Network unreachable | "Cannot reach graph.facebook.com — check your connection" |
Token Refresh
Long-lived tokens expire after 60 days. Use meta_debug_token to check expiry, then refresh:
curl "https://graph.facebook.com/oauth/access_token?\
grant_type=fb_exchange_token&\
client_id=APP_ID&client_secret=APP_SECRET&\
fb_exchange_token=CURRENT_TOKEN"For permanent tokens, create a System User in Business Manager → System Users.
Architecture
src/
├── index.ts Server entry point (stdio transport)
├── constants.ts API versions, base URLs, field constants
├── types.ts TypeScript interfaces for Meta entities
├── services/
│ ├── api.ts MetaApiClient — dual Graph + Threads API
│ └── utils.ts Error handling, formatting, shared schemas
└── tools/
├── pages.ts 52 Facebook Page tools
├── instagram.ts 37 Instagram tools
├── ads.ts 62 Ads Manager tools
├── threads.ts 22 Threads tools
├── commerce.ts 10 Commerce/Catalog tools
├── conversions.ts 2 Conversions API tools
├── audiences.ts 5 Audience tools
├── insights.ts 4 Insight tools
├── charts.ts 2 Chart generation tools
├── ad_library.ts 1 Ad Library tool
└── utility.ts 3 Utility toolsKey Design Decisions
Dual API client — Handles both
graph.facebook.com/v21.0andgraph.threads.net/v1.0with separate base URLs and tokensPage token caching —
meta_list_pagescaches page-scoped tokens; subsequent tools look them up by page IDTwo-step container publishing — Instagram and Threads require container → publish flow; the server handles this automatically with video processing polling
Parallel carousel processing — All carousel items created concurrently via
Promise.allSettled; partial failures report which items succeededZod strict schemas — Every tool uses strict Zod schemas for type-safe parameter validation
Dual output format — Every read tool supports
response_format: "markdown"or"json"Graceful auth — Server starts without tokens, returns setup instructions on first tool call instead of crashing
Chart generation — QuickChart integration for rendering data as PNG images for reports
API Coverage
Targets Meta Graph API v21.0 and Threads API v1.0.
API | Status |
Facebook Pages API | Comprehensive — posts, comments, messaging, insights, events, media, Stories, Reels, Live Video, automated responses |
Instagram Graph API | Comprehensive — publishing, scheduling, comments, DMs, broadcast channels, hashtags, business discovery, insights |
Marketing API | Comprehensive — campaigns, ad sets, ads, creatives, targeting, audiences, pixels, CAPI, A/B testing, Advantage+ |
Threads API | Comprehensive — publishing (text, image, video, GIF, carousel, link), reply controls, location, insights |
Commerce API | Supported — product catalog CRUD, product sets |
Conversions API | Supported — server-side event tracking with test mode |
Ad Library API | Supported — public transparency search |
WhatsApp Business API | Not covered — separate infrastructure and token flow |
Development
Use the same commands for local development and contribution checks:
npm install
npm test # 52 tests
npm run build # TypeScript compilation
npm run test:watch # Development modeDevelopment conventions: Zod .strict() schemas, response_format parameter on read tools, and errorResult() for tool errors with isError: true.
This server cannot be installed
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/oliverames/meta-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server