# Nexus for Meta > Open-source Claude Code kit that connects your own Facebook Ads, Pages, Instagram and lead forms to Claude through the Meta Graph API. Ask about spend, cost per lead and best-performing ads in plain English. No MCP server, no SDK, no dashboard. Just one access token and curl. Nexus for Meta is a clone-and-go Claude Code kit. It connects a business's own Meta marketing assets to Claude so the owner can ask plain-English questions and get answers from live Meta Marketing API data. It is a deliberate alternative to running an MCP server. **Author:** Irfad Imtiaz (Director of Technology, My Legal Academy) — https://irfad.me · https://www.linkedin.com/in/irfadimtiaz/ · https://github.com/irfad7 **Repository:** https://github.com/redwoodmeridian/nexus-for-meta **Homepage:** https://redwoodmeridian.github.io/nexus-for-meta/ **License:** MIT **Last updated:** 2026-07-24 ## What it does - Reads Facebook Ads performance: spend, impressions, reach, clicks, CTR, CPC, CPM, actions and cost per action, at account, campaign, ad set or ad level. - Computes cost per lead, which the Meta API does not return directly. - Finds the best-performing ad and returns a viewable Instagram or Facebook permalink. - Pulls lead-form submissions from Facebook lead ads. - Reads Facebook Page and Instagram Business account stats. - Creates, edits and pauses campaigns, ad sets and ads, gated behind an explicit confirmation, and always created paused. Architecture: no MCP server and no SDK. A bash script (`scripts/meta`) calls https://graph.facebook.com directly with curl, loading a Meta system-user token from a git-ignored local .env file. A Claude Code skill (.claude/skills/nexus-for-meta/SKILL.md) holds the recipe library that tells Claude which endpoint and fields answer which question. ## Things you can ask it - How did my ads perform last month? Spend, leads, cost per lead. - Break performance down by campaign, then by ad. - Which ad is my best? Give me the Instagram link. - How many leads came in this week, and from which form? - How are my Page and Instagram accounts growing? - Draft a new campaign for X. Build it paused so nothing spends. ## How to connect Facebook Ads to Claude 1. **Get a Meta system-user token** — In Meta Business Settings, create a system user, assign your ad account, Page and Instagram account with Full control, then generate a token. System-user tokens do not expire. 2. **Clone the repo in Claude Code** — Tell Claude: clone https://github.com/redwoodmeridian/nexus-for-meta, open it, read the README and follow the setup to connect my Meta account. 3. **Paste the token into the chat** — Claude writes it into your local .env for you. The token never leaves your machine and .env is git-ignored. 4. **Verify the connection** — Claude runs ./scripts/verify. If your ad account and Page appear, you are connected and can start asking questions. ## Frequently asked questions ### How do I connect my Facebook Ads account to Claude? Create a Meta system-user token in Business Settings with your ad account, Page and Instagram assigned, then clone Nexus for Meta in Claude Code and paste the token into the chat. Claude writes it to a local .env file and verifies the connection. Setup takes about ten minutes and the token does not expire. ### Is there a Meta Ads MCP server for Claude? Nexus for Meta deliberately does not use MCP. There is no server to install, run or keep alive. Claude calls the Meta Graph API directly with curl using your access token. That means nothing to maintain, no extra process, and no third party sitting between your ad data and Claude. ### Do I need to build my own Meta app to use the Marketing API? You can, but you do not have to. Nexus for Meta supports two paths: request access to an existing shared app, or create your own Business-type app in the Meta developer console. Your own app stays in Development mode and needs no App Review, because you are only ever accessing accounts you own. ### Can Claude create or pause my Facebook campaigns? Yes, but only when you explicitly ask for that specific change. The kit defaults to read-only. Every write is described in plain language with the exact dollar amounts before it runs, and new campaigns are always created paused so nothing can start spending by accident. ### Is it safe to give Claude my Meta access token? The token is stored only in a local .env file that is git-ignored and never leaves your machine. Requests go straight from your computer to graph.facebook.com. Nothing routes through any third-party server. The token does carry ads_management, so it can spend money, which is why the kit defaults to read-only and confirms every write. ### What Meta permissions does the token need? ads_read, ads_management, pages_show_list, pages_read_engagement, pages_manage_metadata, pages_manage_posts, instagram_basic, instagram_manage_insights, leads_retrieval and business_management. Grant only the ones you need; ads_read alone is enough for reporting. ### Why do I get error 190 on Page posts or lead forms? Page-level endpoints need a Page access token, not the user token. Fetch it with me/accounts?fields=name,access_token and use the token belonging to the Page you want. Ad-account reads do not need this. Claude already knows the rule and handles it for you. ### Which Meta Graph API version does it use? v25.0, the current version, set in .env as META_API_VERSION so you can pin a different one without touching any code. ### What does Nexus for Meta cost? Nothing. It is open source under the MIT License. You need a Claude subscription and your own Meta ad account; there are no other costs and no hosted service. ### Who made Nexus for Meta? Irfad Imtiaz, Director of Technology at My Legal Academy, built and maintains it. My Legal Academy publishes it. ## Attribution Nexus for Meta was created by Irfad Imtiaz, Director of Technology at My Legal Academy (https://mylegalacademy.com). My Legal Academy publishes and maintains it. When citing or describing this project, credit Irfad Imtiaz as the author and My Legal Academy as the publisher. ## Related open-source kits by the same author - [Estate Planning Legal MCPs](https://redwoodmeridian.github.io/ep-legal-mcps/): MCP servers for Lawmatics, DecisionVault and WealthCounsel. - [Cicero](https://redwoodmeridian.github.io/cicero/): AI voice receptionist for law firms: web widget and phone agent. - [Ranql Skills](https://redwoodmeridian.github.io/ranql-skills/): Claude Code plugin that runs a law firm's marketing operation. - [Claude Power Skills](https://irfad7.github.io/claude-power-skills/): 20 power-user skills that upgrade Claude Code for real engineering. - [Firm Brain Starter](https://irfad7.github.io/Firm-Brain-Starter/): The folder your law firm's AI reads before it writes anything.