Facebook Ads MCP Server
This project provides an MCP server acting as an interface to the Facebook Ads, enabling programmatic access to Facebook Ads data and management features.
<video controls width="1920" height="512" src="https://github.com/user-attachments/assets/c4a76dcf-cf5d-4a1d-b976-08165e880fe4">Your browser does not support the video tag.</video>
Easy One-Click Setup
For a simpler setup experience, we offer ready-to-use installers:
- ** Windows:** Download gomarble_mcp_tools.exe
- ** MacOS:** Download gomarble_mcp_tools.pkg
What It Does
- Installs and configures the MCP server locally
- Automatically handles environment setup
- Prompts for Facebook token authentication during the process which is optional
- If facebook access token is not provided then connect to GoMarble's server to create the token on your behalf
Important Disclaimer
This setup does not require you to manually obtain a Facebook Developer Access Token.
Instead, it connects securely to GoMarble's server to create the token on your behalf.
GoMarble does not store your token it is saved locally on your machine for use with the MCP server.
Setup
Prerequisites
- Python 3.10+
- Dependencies listed in
requirements.txt
- (Optional but Recommended) Create and Activate a Virtual Environment:Using a virtual environment helps manage project dependencies cleanly[Source].
- Install Dependencies:
- Obtain Facebook Access Token: Secure a Facebook User Access Token with the necessary permissions (e.g.,
ads_read). You can generate this through the Facebook Developer portal. Follow this link.
Usage with MCP Clients (e.g., Cursor, Claude Desktop)
To integrate this server with an MCP-compatible client, add a configuration(Claude) similar to the following. Replace
YOUR_FACEBOOK_ACCESS_TOKEN with your actual token and adjust the path to server.py if necessary.Restart the MCP Client app after making the update in the configuration.
(Note: On Windows, you might need to adjust the command structure or use `cmd /k` depending on your setup.)
Debugging the Server
Execute
server.py, providing the access token via the --fb-token argument.Available MCP Tools
This MCP server provides tools for interacting with Facebook Ads objects and data:
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
(Note: Most tools support additional parameters like `fields`, `filtering`, `limit`, pagination, date ranges, etc. Refer to the detailed docstrings within `server.py` for the full list and description of arguments for each tool.)
(Note: If your Facebook access token expires, you'll need to generate a new one and update the configuration file of the MCP Client with new token to continue using the tools.)
Dependencies
- mcp (>=1.6.0)
- requests (>=2.32.3)
License
This project is licensed under the MIT License.
Installing via Smithery
To install Facebook Ads Server for Claude Desktop automatically via Smithery:
Facebook Ads MCP Server
This project provides an MCP server acting as an interface to the Facebook Ads, enabling programmatic access to Facebook Ads data and management features.
<video controls width="1920" height="512" src="https://github.com/user-attachments/assets/c4a76dcf-cf5d-4a1d-b976-08165e880fe4">Your browser does not support the video tag.</video>
Easy One-Click Setup
For a simpler setup experience, we offer ready-to-use installers:
- ** Windows:** Download gomarble_mcp_tools.exe
- ** MacOS:** Download gomarble_mcp_tools.pkg
What It Does
- Installs and configures the MCP server locally
- Automatically handles environment setup
- Prompts for Facebook token authentication during the process which is optional
- If facebook access token is not provided then connect to GoMarble's server to create the token on your behalf
Important Disclaimer
This setup does not require you to manually obtain a Facebook Developer Access Token.
Instead, it connects securely to GoMarble's server to create the token on your behalf.
GoMarble does not store your token it is saved locally on your machine for use with the MCP server.
Setup
Prerequisites
- Python 3.10+
- Dependencies listed in
requirements.txt
- (Optional but Recommended) Create and Activate a Virtual Environment:Using a virtual environment helps manage project dependencies cleanly[Source].
- Install Dependencies:
- Obtain Facebook Access Token: Secure a Facebook User Access Token with the necessary permissions (e.g.,
ads_read). You can generate this through the Facebook Developer portal. Follow this link.
Usage with MCP Clients (e.g., Cursor, Claude Desktop)
To integrate this server with an MCP-compatible client, add a configuration(Claude) similar to the following. Replace
YOUR_FACEBOOK_ACCESS_TOKEN with your actual token and adjust the path to server.py if necessary.Restart the MCP Client app after making the update in the configuration.
(Note: On Windows, you might need to adjust the command structure or use `cmd /k` depending on your setup.)
Debugging the Server
Execute
server.py, providing the access token via the --fb-token argument.Available MCP Tools
This MCP server provides tools for interacting with Facebook Ads objects and data:
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
[object Object] | [object Object] |
(Note: Most tools support additional parameters like `fields`, `filtering`, `limit`, pagination, date ranges, etc. Refer to the detailed docstrings within `server.py` for the full list and description of arguments for each tool.)
(Note: If your Facebook access token expires, you'll need to generate a new one and update the configuration file of the MCP Client with new token to continue using the tools.)
Dependencies
- mcp (>=1.6.0)
- requests (>=2.32.3)
License
This project is licensed under the MIT License.
Installing via Smithery
To install Facebook Ads Server for Claude Desktop automatically via Smithery: