Using Danube Tools

All your tools. None of your passwords. Connect to Gmail, Slack, GitHub, Notion, Google Calendar, and 39 more services through Danube's MCP integration.

Setup: If not configured yet, run bash scripts/setup.sh to add Danube MCP to OpenClaw.

When to Use

Use Danube when users want to:

• Send emails, Slack messages, or notifications
• Interact with cloud services (GitHub, Notion, Google Sheets)
• Manage calendars, forms, links, and contacts
• Generate images, translate text, transcribe audio
• Search the web, get weather, browse prediction markets
• Execute any external API action

Don't use for: Local file operations, calculations, or non-API tasks.

Core Workflow

Every tool interaction follows this pattern:

1. Search for Tools

Use search_tools() with natural language:

search_tools("send email")          # → Gmail - Send Email, SendGrid, Resend
search_tools("create github issue") # → GitHub - Create Issue
search_tools("send slack message")  # → Slack - Post Message
search_tools("calendar events")     # → Google Calendar

2. Check Authentication

If tool requires credentials, guide user to connect:

"To use Gmail, you need to connect your account first.

Visit: https://danubeai.com/dashboard
1. Go to Tools section
2. Find Gmail and click 'Connect'
3. Follow the OAuth flow

Let me know when you're ready!"

Always check auth BEFORE attempting execution.

3. Gather Parameters

Ask for missing required parameters:

User: "Send an email"
You: "I can help! I need:
     - Who should I send it to?
     - What's the subject?
     - What should the message say?"

4. Execute Tool

execute_tool(
  tool_id="gmail-send-email-uuid",
  parameters={
    "to": "user@example.com",
    "subject": "Meeting",
    "body": "Confirming our 2pm meeting."
  }
)

5. Handle Response

Success:

"✅ Email sent successfully to user@example.com!"

Auth Error:

"🔐 Authentication failed. Reconnect Gmail at:
https://danubeai.com/dashboard → Tools → Gmail"

Other Error:

"⚠️ Failed: [error]. Let me help troubleshoot..."

Common Patterns

Email Tools (Gmail, SendGrid, Resend)

User: "Email john@example.com about the project"

1. search_tools("send email") → Find Gmail
2. Check Gmail authentication
3. Extract: to="john@example.com", subject="Project"
4. Ask: "What should the message say?"
5. Confirm: "I'll send email to john@example.com. Proceed?"
6. execute_tool()
7. Report: "✅ Email sent!"

Slack Tools

User: "Send a message to #general about the deployment"

1. search_tools("slack send message") → Find Slack - Post Message
2. Check Slack authentication
3. search_tools("slack list channels") → Get channel list
4. execute_tool() to list channels → Find #general channel ID
5. Confirm: "I'll post to #general. Proceed?"
6. execute_tool() to post message
7. Report: "✅ Message posted to #general!"

GitHub Tools

User: "Create issue about the login bug"

1. search_tools("github create issue")
2. Check GitHub authentication
3. Ask: "Which repository?"
4. Ask: "Describe the bug?"
5. execute_tool()
6. Report: "✅ Issue created: [link]"

Calendar Tools

User: "What's on my calendar today?"

1. search_tools("calendar events")
2. Check authentication
3. execute_tool(date=today)
4. Format results:
   "Here's your schedule:
   • 9:00 AM - Team standup
   • 2:00 PM - Client meeting"

Best Practices

✅ Do:

• Search first - Always use search_tools(), don't assume tool IDs
• Check auth - Verify credentials before execution
• Confirm actions - Get user approval for emails, issues, etc.
• Be specific - "Email sent to john@example.com" not just "Done"
• Handle errors - Provide solutions, not just error messages

❌ Don't:

• Assume tool IDs without searching
• Auto-execute without confirmation
• Give vague responses like "Error" or "Done"
• Skip authentication checks

Available MCP Tools

Available Services (44)

Communication & Email: Gmail, Slack, SendGrid, Resend, Loops, AgentMail

Development & DevOps: GitHub, Supabase, DigitalOcean (Droplets, Databases, App Platform, Kubernetes, Networking, Spaces, Accounts, Insights, Marketplace), Stripe, Apify

Productivity: Notion, Google Calendar, Google Sheets, Monday, Typeform, Bitly

AI & ML: Replicate, Together AI, Stability AI, AssemblyAI, Remove.bg

Search & Data: Exa, Exa Websets, Firecrawl, Serper, Context7, Microsoft Learn, AlphaVantage

Translation: DeepL

Public Data (No Auth): Hacker News, Open-Meteo Weather, OpenWeather, REST Countries, Polymarket, Kalshi

Error Handling

Authentication (401):

"🔐 [Service] requires authentication.
Visit https://danubeai.com/dashboard → Tools → [Service] → Connect"

Missing Parameters:

"I need:
• [param1]: [description]
• [param2]: [description]"

Rate Limit:

"⚠️ Hit rate limit for [Service].
• Try again in a few minutes
• Use alternative service
• Break into smaller batches"

Multi-Step Workflows

Some tasks need multiple tools:

User: "Post a summary of today's GitHub commits to Slack"

1. search_tools("github commits") → Get tool
2. execute_tool() → Fetch commits
3. Format into summary
4. search_tools("slack post message") → Get Slack tool
5. search_tools("slack list channels") → Find target channel
6. execute_tool() → Post to Slack
7. Report: "✅ Posted summary of 5 commits to #dev-updates!"

Communication Templates

Request Auth:

"To use [Service], connect your account:
1. Visit https://danubeai.com/dashboard
2. Tools → [Service] → Connect
3. Come back when ready!"

Confirm Execution:

"I'll [action] using [Tool].
Parameters: [list]
Proceed?"

Report Success:

"✅ Done!
[Specific result]
[Link if applicable]"

Quick Reference

Workflow:

1. User requests action
2. search_tools() → Find tool
3. Check authentication → Guide if needed
4. Gather parameters → Ask for missing info
5. Confirm → Get approval
6. execute_tool() → Run it
7. Report → Success or error

Key URLs:

• MCP Server: https://mcp.danubeai.com/mcp
• Dashboard: https://danubeai.com/dashboard
• Connect Services: https://danubeai.com/dashboard → Tools

Debug:

• Restart: openclaw gateway restart
• Check errors: openclaw doctor
• Verify API key at: https://danubeai.com/dashboard