MCP OpenClaw
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP OpenClaw Send a Telegram message to @john saying I've finished the report"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP OpenClaw
A Model Context Protocol (MCP) server that integrates with the OpenClaw API, enabling AI assistants to send messages, execute commands, manage calendar events, send emails, and track task status.
Features
Send Messages: Send messages to Telegram, WhatsApp, and Discord
Execute Commands: Run commands in the OpenClaw environment (sync or async)
Calendar Management: Create calendar events with attendees and reminders
Email: Send emails with support for CC/BCC
Task Status: Track the status of asynchronous commands
Related MCP server: Jilebi
Installation
Global Installation
npm install -g mcp-openclawLocal Installation
npm install mcp-openclawConfiguration
Set the following environment variables:
export OPENCLAW_API_URL="https://api.openclaw.example.com"
export OPENCLAW_API_KEY="your-api-key-here"Optional configuration:
export OPENCLAW_TIMEOUT="30000" # Request timeout in milliseconds (default: 30000)
export OPENCLAW_MAX_RETRIES="3" # Maximum retry attempts (default: 3)
export SERVER_NAME="mcp-openclaw" # Server name (default: mcp-openclaw)
export SERVER_VERSION="1.0.0" # Server version (default: 1.0.0)
export LOG_LEVEL="info" # Log level: debug, info, warn, error (default: info)Usage
With Claude Desktop
Add to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"openclaw": {
"command": "node",
"args": ["/path/to/mcp-openclaw/dist/index.js"],
"env": {
"OPENCLAW_API_URL": "https://api.openclaw.example.com",
"OPENCLAW_API_KEY": "your-api-key-here"
}
}
}
}Available Tools
1. send_message
Send a message to a supported platform.
{
"platform": "telegram",
"recipient": "@username",
"message": "Hello from OpenClaw!"
}Supported platforms: telegram, whatsapp, discord
2. execute_command
Execute a command in the OpenClaw environment.
{
"command": "ls -la",
"timeout": 30,
"async": false
}3. create_calendar_event
Create a new calendar event.
{
"title": "Team Meeting",
"description": "Weekly team sync",
"startTime": "2024-01-15T10:00:00Z",
"endTime": "2024-01-15T11:00:00Z",
"location": "Conference Room A",
"attendees": ["user1@example.com", "user2@example.com"],
"reminder": 15
}4. send_email
Send an email.
{
"to": "recipient@example.com",
"subject": "Hello from OpenClaw",
"body": "This is the email content",
"cc": "cc@example.com",
"bcc": "bcc@example.com",
"html": false
}5. get_task_status
Check the status of an asynchronous command.
{
"taskId": "task-abc123"
}Development
Setup
git clone https://github.com/yourusername/mcp-openclaw.git
cd mcp-openclaw
npm installBuild
npm run buildTest
npm testLint
npm run lint
npm run lint:fixFormat
npm run formatProject Structure
mcp-openclaw/
├── src/
│ ├── index.ts # MCP Server entry point
│ ├── types.ts # TypeScript type definitions
│ ├── openclaw-client.ts # OpenClaw API client
│ └── tools/
│ ├── index.ts # Tools registry
│ ├── send-message.ts
│ ├── execute-command.ts
│ ├── create-calendar-event.ts
│ ├── send-email.ts
│ └── get-task-status.ts
├── tests/ # Test files
├── examples/ # Usage examples
├── docs/ # Documentation
└── scripts/ # Build and utility scriptsArchitecture
For detailed architecture information, see docs/ARCHITECTURE.md.
API Reference
For the complete API reference, see docs/API.md.
Contributing
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
License
MIT License - see LICENSE for details.
Changelog
See CHANGELOG.md for version history.
Support
Issues: GitHub Issues
Documentation: docs/
Available Tools
5 toolscreate_calendar_eventC
Create a calendar event with title, description, time, location, and attendees
Inputs: title (required), startTime (required), description, endTime, +3 more.
execute_commandC
Execute a command in the OpenClaw environment. Commands can run synchronously or asynchronously.
Inputs: command (required), timeout, async.
get_task_statusC
Get the current status of a previously executed async command/task
Inputs: taskId (required).
send_emailC
Send an email to one or more recipients with optional CC and BCC
Inputs: to (required), subject (required), body (required), cc, +2 more.
send_messageC
Send a message to a specified platform (Telegram, WhatsApp, or Discord) via OpenClaw
Inputs: platform (required), recipient (required), message (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Most tools have distinct purposes: calendar event creation, command execution, task status checking, email sending, and message sending. However, 'send_email' and 'send_message' could potentially be confused as both involve communication, though their target platforms differ (email vs. messaging apps).
All tool names follow a consistent verb_noun pattern (e.g., create_calendar_event, execute_command, get_task_status, send_email, send_message). The naming is uniform and predictable throughout the set.
With 5 tools, the count is reasonable and well-scoped for a utility server like OpenClaw. It covers key automation tasks without being overwhelming, though it might benefit from a few more tools for broader coverage.
The tool set covers basic automation tasks (execution, communication, calendar), but there are notable gaps. For example, there's no tool to list or manage calendar events, update tasks, or handle other common operations like file management, which could limit agent workflows.
Maintenance
Related MCP Connectors
An MCP server that integrates with Discord to provide AI-powered features.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
- FlicenseCqualityDmaintenanceA powerful MCP server that enables AI assistants to interact with Microsoft Graph API for managing Outlook emails, Calendar events, OneDrive files, and Contacts through natural language commands.3556-
- AlicenseNot gradedqualityBmaintenanceA plugin-based MCP server that enables AI assistants to interact with external systems through custom tools, resources, and prompts.4AGPL 3.0
- AlicenseNot gradedqualityDmaintenanceAn MCP server with real AI capabilities (OpenAI/Anthropic) for natural language understanding, multi-step planning, and autonomous task execution, enabling intelligent file analysis, weather-based planning, and more.ISC
- AlicenseAqualityDmaintenanceMCP server that integrates OpenClaw AI assistant with Claude Code, enabling chat, task management, messaging, memory, alerts, agent spawning, and web search through configurable tools.12406 npmMIT