Apify Extension
This tutorial covers how to add the Apify MCP server as a goose extension, enabling goose to call thousands of tools from Apify Store to extract data from social media, e-commerce sites, search engines, online maps, or any other website.
Configuration
- Apify Remote MCP
- Apify Local MCP
- goose Desktop
- goose CLI
Use Add custom extension
in Settings → Extensions to add a Streamable HTTP
extension type with:
Use goose configure
to add a Remote Extension (Streaming HTTP)
extension type with:
Endpoint URL
https://mcp.apify.com
- goose Desktop
- goose CLI
- Obtain an Apify Token
- Click the button in the top-left to open the sidebar
- Click
Extensions
- Click
Add custom extension
- On the
Add custom extension
modal, enter the following:- Extension Name: Apify
- Type: Streamable HTTP
- Endpoint:
https://mcp.apify.com
- Request Headers:
- Header name:
Authorization
- Value:
Bearer <YOUR_APIFY_TOKEN>
- Header name:
- Click
+ Add
to save the header - Click
Add Extension
to save the extension - Navigate to the chat
- Run the
configure
command:
goose configure
- Choose to add a
Remote Extension (Streaming HTTP)
.
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◆ What type of extension would you like to add?
│ ○ Built-in Extension
│ ○ Command-line Extension
│ ○ Remote Extension (SSE)
│ ● Remote Extension (Streaming HTTP) (Connect to a remote extension via MCP Streaming HTTP)
└
- Give your extension a name.
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Remote Extension (Streaming HTTP)
│
◆ What would you like to call this extension?
│ apify-mcp
└
- Enter the Streaming HTTP endpoint URI.
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Remote Extension (Streaming HTTP)
│
◇ What would you like to call this extension?
│ apify-mcp
│
◆ What is the Streaming HTTP endpoint URI?
│ https://mcp.apify.com
└
- Enter the number of seconds Goose should wait for actions to complete before timing out. Default is
300
seconds.
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Remote Extension (Streaming HTTP)
│
◇ What would you like to call this extension?
│ apify-mcp
│
◇ What is the Streaming HTTP endpoint URI?
│ https://mcp.apify.com
│
◆ Please set the timeout for this tool (in secs):
│ 300
└
- Choose to add a description. If you select
No
, Goose will skip it.
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Remote Extension (Streaming HTTP)
│
◇ What would you like to call this extension?
│ apify-mcp
│
◇ What is the Streaming HTTP endpoint URI?
│ https://mcp.apify.com
│
◇ Please set the timeout for this tool (in secs):
│ 300
│
◆ Would you like to add a description?
│ No
└
- Add custom header for apify-mcp.
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Remote Extension (Streaming HTTP)
│
◇ What would you like to call this extension?
│ apify-mcp
│
◇ What is the Streaming HTTP endpoint URI?
│ https://mcp.apify.com
│
◇ Please set the timeout for this tool (in secs):
│ 300
│
◇ Would you like to add a description?
│ No
│
◆ Would you like to add custom headers?
│ Yes
│
◇ Header name:
│ Authorization
│
◇ Header value:
│ Bearer apify_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
│
◇ Add another header?
│ No
│
└ Added apify-mcp extension
Obtain your Apify Token and paste it in.
- goose Desktop
- goose CLI
Command
npx -y @apify/actors-mcp-server
Environment Variables
APIFY_TOKEN: <YOUR_APIFY_TOKEN>
- goose Desktop
- goose CLI
- Obtain an Apify Token
- Click the button in the top-left to open the sidebar
- Click
Extensions
- Click
Add custom extension
- On the
Add custom extension
modal, enter the following:- Extension Name: Apify
- Type: STDIO
- Command:
npx -y @apify/actors-mcp-server
- Environment Variables:
- Variable name:
APIFY_TOKEN
- Value:
<YOUR_APIFY_TOKEN>
- Variable name:
- Click
+ Add
to save the header - Click
Add Extension
to save the extension - Navigate to the chat
- Run the
configure
command:
goose configure
- Choose to add a
Command-line Extension
.
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◆ What type of extension would you like to add?
│ ○ Built-in Extension
│ ● Command-line Extension (Run a local command or script)
│ ○ Remote Extension (SSE)
│ ○ Remote Extension (Streaming HTTP)
└
- Give your extension a name.
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Command-line Extension
│
◆ What would you like to call this extension?
│ apify-mcp
└
- Enter the command to run when this extension is used.
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Command-line Extension
│
◇ What would you like to call this extension?
│ apify-mcp
│
◆ What command should be run?
│ npx -y @apify/actors-mcp-server
└
- Enter the number of seconds Goose should wait for actions to complete before timing out. Default is
300
seconds.
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Command-line Extension
│
◇ What would you like to call this extension?
│ apify-mcp
│
◇ What command should be run?
│ npx -y @apify/actors-mcp-server
│
◆ Please set the timeout for this tool (in secs):
│ 300
└
- Choose to add a description. If you select
No
, Goose will skip it.
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Command-line Extension
│
◇ What would you like to call this extension?
│ apify-mcp
│
◇ What command should be run?
│ npx -y @apify/actors-mcp-server
│
◇ Please set the timeout for this tool (in secs):
│ 300
│
◆ Would you like to add a description?
│ No
└
- Add environment variable for apify-mcp.
┌ goose-configure
│
◇ What would you like to configure?
│ Add Extension
│
◇ What type of extension would you like to add?
│ Command-line Extension
│
◇ What would you like to call this extension?
│ apify-mcp
│
◇ What command should be run?
│ npx -y @apify/actors-mcp-server
│
◇ Please set the timeout for this tool (in secs):
│ 300
│
◇ Would you like to add a description?
│ No
│
◆ Would you like to add environment variables?
│ Yes
│
◇ Environment variable name:
│ APIFY_TOKEN
│
◇ Environment variable value:
│ apify_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
│
◇ Add another environment variable?
│ No
│
└ Added apify-mcp extension
Obtain your Apify Token and paste it in.
Example Usage
The Apify MCP server lets you connect goose to Apify Store, a marketplace of thousands of ready-made tools (called Actors) for all kinds of web scraping, crawling, and data extraction use cases. Learn more about Apify Actors in the official documentation
In this example, goose will use the Google Places Scraper Actor to identify the most credible, top-rated Italian restaurant in Prague based on public ratings, reviews, and fine-dining recognition.
Goose Prompt
( O)> Find the top-rated Italian restaurant in Prague with verifiable credibility — use Apify MCP to find Google Maps review scraper Actor, focus on places with at least 200+ reviews, an average rating of 4.7 or higher on Google, TripAdvisor, or OpenTable, and any Michelin or fine-dining recognition. Include the restaurant’s name, rating, total review count, address, cuisine style, and a short summary of what makes it stand out (e.g., service, ambiance, or signature dishes). Return to me only 1 restaurant with the highest rating to review count ratio
Goose Output
Based on the gathered information, the top-rated Italian restaurant in Prague with verifiable credibility is:
### **Al Tagliere**
* **Rating:** 4.7/5
* **Total Reviews:** 457
* **Address:** [Al Tagliere on TripAdvisor](https://www.tripadvisor.com/Restaurant_Review-g274707-d6835155-Reviews-Al_Tagliere-Prague_Bohemia.html)
* **Cuisine Style:** Italian
* **Summary:** Al Tagliere is celebrated for its authentic Italian dishes that showcase regional flavors. The restaurant is known for its delightful ambiance, attentive service, and signature dishes such as homemade pasta and traditional desserts. Patrons frequently highlight the freshness of ingredients and the welcoming atmosphere, making it a preferred choice for both locals and tourists.
This restaurant has a strong reputation and meets your criteria for quality and credibility.