From 879592446e365b75a3b7f18cefe4d5a776372f85 Mon Sep 17 00:00:00 2001 From: Prathit-tech Date: Mon, 8 Sep 2025 11:31:25 +0530 Subject: [PATCH 1/4] docs: add Rube extension documentation and server configuration Signed-off-by: Prathit-tech --- documentation/docs/mcp/rube.md | 157 ++++++++++++++++++++++++++++++ documentation/static/servers.json | 12 +++ 2 files changed, 169 insertions(+) create mode 100644 documentation/docs/mcp/rube.md diff --git a/documentation/docs/mcp/rube.md b/documentation/docs/mcp/rube.md new file mode 100644 index 000000000000..609513f745a1 --- /dev/null +++ b/documentation/docs/mcp/rube.md @@ -0,0 +1,157 @@ +--- +title: Rube +description: Add Rube as a Goose Extension to connect with 500+ apps +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +import CLIExtensionInstructions from '@site/src/components/CLIExtensionInstructions'; +import { PanelLeft } from 'lucide-react'; + +This tutorial covers how to add [Rube](https://rube.app) as a Goose extension to enable seamless integration with 500+ apps including Slack, Gmail, Notion, Google Workspace, Microsoft Office, GitHub, and many more. + +:::tip TLDR + + + 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://rube.app/mcp + ``` + **Authentication**: OAuth browser authentication (no manual tokens required) +::: + +## What is Rube? + +Rube is a platform powered by Composio that provides unified access to 500+ apps and services through a single integration. It enables seamless connectivity across different applications without additional setup, making it perfect for both individual users and teams. Rube provides a consistent interface for: + +- **Communication**: Slack, Discord, Microsoft Teams, WhatsApp, Telegram +- **Productivity**: Gmail, Outlook, Google Workspace, Microsoft 365, Notion, Airtable +- **Development**: GitHub, GitLab, Jira, Linear, Figma +- **CRM & Sales**: Salesforce, HubSpot, Pipedrive +- **Finance**: Stripe, QuickBooks, PayPal +- **And 500+ more apps + +## Configuration + + + + 1. Click the button in the top-left to open the sidebar + 2. Click `Extensions` + 3. Click `Add custom extension` + 4. On the `Add custom extension` modal, enter the following: + - **Extension Name**: Rube + - **Type**: Streamable HTTP + - **Endpoint**: `https://rube.app/mcp` + - **Timeout**: 300 (or adjust as needed) + 5. Click `Add Extension` to save the extension + 6. Navigate to the chat and start using Rube - OAuth authentication will happen automatically when needed + + + + + + + + +## Authentication + +Rube uses OAuth browser authentication, which means: +- No manual API keys to manage +- Secure authentication handled automatically +- When you first use a Rube tool, your browser will open to authenticate with the relevant service +- Authentication tokens are securely stored and managed by Rube + +## Example Usage + +### Email Management +``` +Send an email to john@example.com with the subject "Project Update" and tell him about our progress on the new feature. +``` + +### Slack Integration +``` +Post a message to the #general channel in Slack about the team meeting tomorrow at 2 PM. +``` + +### Google Sheets Operations +``` +Create a new Google Sheet called "Q1 Sales Data" and add headers for Date, Product, Revenue, and Customer. +``` + +### GitHub Integration +``` +Create a new issue in my project repository titled "Bug: Login form validation" and assign it to the development team. +``` + +### Multi-App Workflows +``` +Get my latest emails from Gmail, summarize them, and post a daily digest to our team Slack channel. +``` + +### Notion Database Management +``` +Add a new entry to my "Project Tasks" Notion database with the task "Implement user authentication" marked as high priority. +``` + +## Supported Apps + +Rube provides access to 500+ applications across categories including: + +**Communication & Collaboration** +- Slack, Discord, Microsoft Teams +- Gmail, Outlook, Sendbird +- WhatsApp, Telegram, Superchat + +**Productivity & Organization** +- Google Workspace (Docs, Sheets, Drive, Calendar) +- Microsoft 365 (Word, Excel, OneDrive, Outlook) +- Notion, Airtable, Monday.com +- Trello, Asana, ClickUp + +**Development & Design** +- GitHub, GitLab, Bitbucket +- Jira, Linear, Figma + +**CRM & Sales** +- Salesforce, HubSpot, Pipedrive +- Zendesk, Intercom, Freshworks +- Stripe, Apollo, Attio + +**And many more!** + +## Benefits of Using Rube + +1. **Unified Interface**: One extension to access 500+ apps instead of managing multiple MCP servers +2. **Simplified Authentication**: OAuth flows handled automatically - no manual API key management +3. **Cross-App Workflows**: Easily chain actions across different services +4. **Always Up-to-Date**: New app integrations and API updates handled by the Rube team +5. **Secure**: Enterprise-grade security with OAuth 2.0 and secure token management + +## Troubleshooting + +**Extension not connecting**: Ensure you have a stable internet connection and that `https://rube.app` is accessible from your network. + +**Authentication issues**: If OAuth flows aren't working, try clearing your browser cache or using a different browser. + +**Tool timeouts**: Some operations with large datasets may take longer. You can increase the timeout value in the extension settings if needed. + +**Rate limits**: Rube respects the rate limits of individual services. If you hit limits, wait a few minutes before retrying. + +## Getting Help + +- Visit [rube.app](https://rube.app) for documentation and support +- Check the Rube status page for any service interruptions +- Contact Rube support for integration-specific questions \ No newline at end of file diff --git a/documentation/static/servers.json b/documentation/static/servers.json index e228493fc541..db08a06e1d8f 100644 --- a/documentation/static/servers.json +++ b/documentation/static/servers.json @@ -542,6 +542,18 @@ "endorsed": false, "environmentVariables": [] }, + { + "id": "rube", + "name": "Rube", + "description": "Connect with 500+ apps like Slack, Gmail, Notion and more through unified integrations", + "type": "streamable-http", + "url": "https://rube.app/mcp", + "link": "https://rube.app", + "installation_notes": "Streaming HTTP extension with OAuth browser authentication to your Rube account.", + "is_builtin": false, + "endorsed": true, + "environmentVariables": [] + }, { "id": "selenium-mcp", "name": "Selenium", From 4d1d8d3f6ceb00f4d1038a7739d2a8add57e66d1 Mon Sep 17 00:00:00 2001 From: Prathit-tech Date: Fri, 12 Sep 2025 09:14:39 +0530 Subject: [PATCH 2/4] docs: implement PR feedback for Rube MCP extension documentation - Add GooseDesktopInstaller import and component usage - Update TLDR section with installer component for Desktop tab - Move endpoint URL details to CLI tab only - Remove 'Benefits of Using Rube' section - Improve formatting and structure Signed-off-by: Prathit-tech --- documentation/docs/mcp/rube-mcp.md | 94 +++++++++++++++++ documentation/docs/mcp/rube.md | 157 ----------------------------- documentation/static/servers.json | 2 +- 3 files changed, 95 insertions(+), 158 deletions(-) create mode 100644 documentation/docs/mcp/rube-mcp.md delete mode 100644 documentation/docs/mcp/rube.md diff --git a/documentation/docs/mcp/rube-mcp.md b/documentation/docs/mcp/rube-mcp.md new file mode 100644 index 000000000000..dabd5cc35aa9 --- /dev/null +++ b/documentation/docs/mcp/rube-mcp.md @@ -0,0 +1,94 @@ +--- +title: Rube Extension +description: Add Rube as a Goose Extension to connect with 500+ apps +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +import CLIExtensionInstructions from '@site/src/components/CLIExtensionInstructions'; +import GooseDesktopInstaller from '@site/src/components/GooseDesktopInstaller'; +import { PanelLeft } from 'lucide-react'; + +This tutorial covers how to add [Rube](https://rube.app) as a Goose extension to enable seamless integration with 500+ apps including Slack, Gmail, Notion, Google Workspace, Microsoft Office, GitHub, and many more. + +:::tip TLDR + + + + + + Use `goose configure` to add a `Remote Extension (Streaming HTTP)` extension type with: + + **Endpoint URL** + ``` + https://rube.app/mcp + ``` + **Authentication**: OAuth browser authentication (no manual tokens required) + + +::: + +## What is Rube? + +Rube is a platform powered by Composio that provides unified access to 500+ apps and services through a single integration. It enables seamless connectivity across different applications without additional setup, making it perfect for both individual users and teams. Rube provides a consistent interface for: + +- **Communication**: Slack, Discord, Microsoft Teams, WhatsApp, Telegram +- **Productivity**: Gmail, Outlook, Google Workspace, Microsoft 365, Notion, Airtable +- **Development**: GitHub, GitLab, Jira, Linear, Figma +- **CRM & Sales**: Salesforce, HubSpot, Pipedrive +- **Finance**: Stripe, QuickBooks, PayPal +- **And 500+ more apps** + +## Configuration + + + + 1. Click the button in the top-left to open the sidebar + 2. Click `Extensions` + 3. Click `Add custom extension` + 4. On the `Add custom extension` modal, enter the following: + - **Extension Name**: Rube + - **Type**: Streamable HTTP + - **Endpoint**: `https://rube.app/mcp` + - **Timeout**: 300 (or adjust as needed) + 5. Click `Add Extension` to save the extension + 6. Navigate to the chat and start using Rube - OAuth authentication will happen automatically when needed + + + + + + + + +## Authentication + +Rube uses OAuth browser authentication, which means: +- No manual API keys to manage +- Secure authentication handled automatically +- When you first use a Rube tool, your browser will open to authenticate with the relevant service +- Authentication tokens are securely stored and managed by Rube + +## Troubleshooting + +- **Extension not connecting**: Ensure you have a stable internet connection and that `https://rube.app` is accessible from your network. +- **Authentication issues**: If OAuth flows aren't working, try clearing your browser cache or using a different browser. +- **Tool timeouts**: Some operations with large datasets may take longer. You can increase the timeout value in the extension settings if needed. +- **Rate limits**: Rube respects the rate limits of individual services. If you hit limits, wait a few minutes before retrying. + +## Getting Help + +- Visit [rube.app](https://rube.app) for documentation and support for integration-specific questions +- Check the Rube status page for any service interruptions \ No newline at end of file diff --git a/documentation/docs/mcp/rube.md b/documentation/docs/mcp/rube.md deleted file mode 100644 index 609513f745a1..000000000000 --- a/documentation/docs/mcp/rube.md +++ /dev/null @@ -1,157 +0,0 @@ ---- -title: Rube -description: Add Rube as a Goose Extension to connect with 500+ apps ---- - -import Tabs from '@theme/Tabs'; -import TabItem from '@theme/TabItem'; -import CLIExtensionInstructions from '@site/src/components/CLIExtensionInstructions'; -import { PanelLeft } from 'lucide-react'; - -This tutorial covers how to add [Rube](https://rube.app) as a Goose extension to enable seamless integration with 500+ apps including Slack, Gmail, Notion, Google Workspace, Microsoft Office, GitHub, and many more. - -:::tip TLDR - - - 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://rube.app/mcp - ``` - **Authentication**: OAuth browser authentication (no manual tokens required) -::: - -## What is Rube? - -Rube is a platform powered by Composio that provides unified access to 500+ apps and services through a single integration. It enables seamless connectivity across different applications without additional setup, making it perfect for both individual users and teams. Rube provides a consistent interface for: - -- **Communication**: Slack, Discord, Microsoft Teams, WhatsApp, Telegram -- **Productivity**: Gmail, Outlook, Google Workspace, Microsoft 365, Notion, Airtable -- **Development**: GitHub, GitLab, Jira, Linear, Figma -- **CRM & Sales**: Salesforce, HubSpot, Pipedrive -- **Finance**: Stripe, QuickBooks, PayPal -- **And 500+ more apps - -## Configuration - - - - 1. Click the button in the top-left to open the sidebar - 2. Click `Extensions` - 3. Click `Add custom extension` - 4. On the `Add custom extension` modal, enter the following: - - **Extension Name**: Rube - - **Type**: Streamable HTTP - - **Endpoint**: `https://rube.app/mcp` - - **Timeout**: 300 (or adjust as needed) - 5. Click `Add Extension` to save the extension - 6. Navigate to the chat and start using Rube - OAuth authentication will happen automatically when needed - - - - - - - - -## Authentication - -Rube uses OAuth browser authentication, which means: -- No manual API keys to manage -- Secure authentication handled automatically -- When you first use a Rube tool, your browser will open to authenticate with the relevant service -- Authentication tokens are securely stored and managed by Rube - -## Example Usage - -### Email Management -``` -Send an email to john@example.com with the subject "Project Update" and tell him about our progress on the new feature. -``` - -### Slack Integration -``` -Post a message to the #general channel in Slack about the team meeting tomorrow at 2 PM. -``` - -### Google Sheets Operations -``` -Create a new Google Sheet called "Q1 Sales Data" and add headers for Date, Product, Revenue, and Customer. -``` - -### GitHub Integration -``` -Create a new issue in my project repository titled "Bug: Login form validation" and assign it to the development team. -``` - -### Multi-App Workflows -``` -Get my latest emails from Gmail, summarize them, and post a daily digest to our team Slack channel. -``` - -### Notion Database Management -``` -Add a new entry to my "Project Tasks" Notion database with the task "Implement user authentication" marked as high priority. -``` - -## Supported Apps - -Rube provides access to 500+ applications across categories including: - -**Communication & Collaboration** -- Slack, Discord, Microsoft Teams -- Gmail, Outlook, Sendbird -- WhatsApp, Telegram, Superchat - -**Productivity & Organization** -- Google Workspace (Docs, Sheets, Drive, Calendar) -- Microsoft 365 (Word, Excel, OneDrive, Outlook) -- Notion, Airtable, Monday.com -- Trello, Asana, ClickUp - -**Development & Design** -- GitHub, GitLab, Bitbucket -- Jira, Linear, Figma - -**CRM & Sales** -- Salesforce, HubSpot, Pipedrive -- Zendesk, Intercom, Freshworks -- Stripe, Apollo, Attio - -**And many more!** - -## Benefits of Using Rube - -1. **Unified Interface**: One extension to access 500+ apps instead of managing multiple MCP servers -2. **Simplified Authentication**: OAuth flows handled automatically - no manual API key management -3. **Cross-App Workflows**: Easily chain actions across different services -4. **Always Up-to-Date**: New app integrations and API updates handled by the Rube team -5. **Secure**: Enterprise-grade security with OAuth 2.0 and secure token management - -## Troubleshooting - -**Extension not connecting**: Ensure you have a stable internet connection and that `https://rube.app` is accessible from your network. - -**Authentication issues**: If OAuth flows aren't working, try clearing your browser cache or using a different browser. - -**Tool timeouts**: Some operations with large datasets may take longer. You can increase the timeout value in the extension settings if needed. - -**Rate limits**: Rube respects the rate limits of individual services. If you hit limits, wait a few minutes before retrying. - -## Getting Help - -- Visit [rube.app](https://rube.app) for documentation and support -- Check the Rube status page for any service interruptions -- Contact Rube support for integration-specific questions \ No newline at end of file diff --git a/documentation/static/servers.json b/documentation/static/servers.json index db08a06e1d8f..205656adfa73 100644 --- a/documentation/static/servers.json +++ b/documentation/static/servers.json @@ -543,7 +543,7 @@ "environmentVariables": [] }, { - "id": "rube", + "id": "rube-mcp", "name": "Rube", "description": "Connect with 500+ apps like Slack, Gmail, Notion and more through unified integrations", "type": "streamable-http", From b87f1be0d78bab7ac516c6fd8bb048e726b0cb7a Mon Sep 17 00:00:00 2001 From: Prathit-tech Date: Fri, 12 Sep 2025 22:56:24 +0530 Subject: [PATCH 3/4] fix: update desktop installer and tldr section to use deeplinks Signed-off-by: Prathit-tech --- documentation/docs/mcp/rube-mcp.md | 39 +++++++++--------------------- 1 file changed, 12 insertions(+), 27 deletions(-) diff --git a/documentation/docs/mcp/rube-mcp.md b/documentation/docs/mcp/rube-mcp.md index dabd5cc35aa9..35bf99f0a179 100644 --- a/documentation/docs/mcp/rube-mcp.md +++ b/documentation/docs/mcp/rube-mcp.md @@ -14,13 +14,7 @@ This tutorial covers how to add [Rube](https://rube.app) as a Goose extension to :::tip TLDR - + [Launch the installer](goose://extension?type=streamable_http&url=https%3A%2F%2Frube.app%2Fmcp&id=rube&name=Rube&description=Seamlessly%20connect%20across%20500%2B%20applications%20including%20Slack%2C%20Gmail%2C%20Notion%2C%20Google%20Workspace%2C%20Microsoft%20Office%2C%20GitHub%2C%20and%20many%20more) Use `goose configure` to add a `Remote Extension (Streaming HTTP)` extension type with: @@ -29,37 +23,28 @@ This tutorial covers how to add [Rube](https://rube.app) as a Goose extension to ``` https://rube.app/mcp ``` - **Authentication**: OAuth browser authentication (no manual tokens required) + +:::info OAUTH FLOW +An OAuth window will open in your browser. Follow the prompts to authorize access to your Rube account. ::: ## What is Rube? -Rube is a platform powered by Composio that provides unified access to 500+ apps and services through a single integration. It enables seamless connectivity across different applications without additional setup, making it perfect for both individual users and teams. Rube provides a consistent interface for: - -- **Communication**: Slack, Discord, Microsoft Teams, WhatsApp, Telegram -- **Productivity**: Gmail, Outlook, Google Workspace, Microsoft 365, Notion, Airtable -- **Development**: GitHub, GitLab, Jira, Linear, Figma -- **CRM & Sales**: Salesforce, HubSpot, Pipedrive -- **Finance**: Stripe, QuickBooks, PayPal -- **And 500+ more apps** +Rube is a platform powered by Composio that provides unified access to 500+ apps and services through a single integration. It enables seamless connectivity across different applications without additional setup, making it perfect for both individual users and teams. ## Configuration - 1. Click the button in the top-left to open the sidebar - 2. Click `Extensions` - 3. Click `Add custom extension` - 4. On the `Add custom extension` modal, enter the following: - - **Extension Name**: Rube - - **Type**: Streamable HTTP - - **Endpoint**: `https://rube.app/mcp` - - **Timeout**: 300 (or adjust as needed) - 5. Click `Add Extension` to save the extension - 6. Navigate to the chat and start using Rube - OAuth authentication will happen automatically when needed - + Date: Fri, 12 Sep 2025 23:24:18 +0530 Subject: [PATCH 4/4] feat: add example usage section Signed-off-by: Prathit-tech --- documentation/docs/mcp/rube-mcp.md | 31 ++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/documentation/docs/mcp/rube-mcp.md b/documentation/docs/mcp/rube-mcp.md index 35bf99f0a179..f3d44b2258b3 100644 --- a/documentation/docs/mcp/rube-mcp.md +++ b/documentation/docs/mcp/rube-mcp.md @@ -66,6 +66,37 @@ Rube uses OAuth browser authentication, which means: - When you first use a Rube tool, your browser will open to authenticate with the relevant service - Authentication tokens are securely stored and managed by Rube +## Example Usage + +Once Rube is configured, you can interact with 500+ apps directly through Goose. Here are some examples: + +**Email Management** +``` +Send an email to john@example.com with subject "Meeting Update" and body "The meeting has been moved to 3 PM" +``` + +**Slack Communication** +``` +Post a message to the #general channel saying "Deploy completed successfully" +``` + +**GitHub Integration** +``` +Create a new issue in my repository with title "Bug Report" and description "Found an issue with the login flow" +``` + +**Google Sheets** +``` +Add a new row to my "Sales Data" spreadsheet with values: Date: today, Amount: 1500, Client: Acme Corp +``` + +**Calendar Management** +``` +Schedule a meeting for tomorrow at 2 PM with title "Project Review" and invite sarah@company.com +``` + +The first time you use tools for a specific service, you'll be prompted to authenticate through OAuth in your browser. After that, all subsequent interactions with that service will work seamlessly. + ## Troubleshooting - **Extension not connecting**: Ensure you have a stable internet connection and that `https://rube.app` is accessible from your network.