Connect OpenClaw to
500+ Tools with MCP
The Model Context Protocol is the universal plug socket for AI agents. Add one entry to your config file and OpenClaw gets native access to GitHub, Notion, Stripe, Slack, your filesystem, and hundreds more — no custom code required.
What Is MCP?
Model Context Protocol (MCP) is an open standard — created by Anthropic and donated to the Linux Foundation in late 2025 — that defines a single, universal way for AI agents to connect to external tools and data sources.
Think of MCP like USB-C for AI. Before MCP, every integration required custom code — a different API client for GitHub, another for Notion, another for Stripe. MCP gives every tool the same connector. OpenClaw speaks MCP natively, so any MCP server you add instantly becomes a tool your agent can use.
OpenClaw Agent
Decides to use a tool, sends an MCP request
MCP Server
Translates the request into the external API's format
External Service
GitHub, Notion, Stripe, your filesystem — anything
Result Back
Response returned to OpenClaw in a standard format
One config, every tool
All MCP servers are added the same way — a few lines in openclaw.json. No custom integrations, no SDKs, no boilerplate code to write.
500+ servers available
GitHub, Notion, Stripe, Slack, Linear, Jira, Confluence, PostgreSQL, Brave Search, and hundreds more — most are free and open-source.
Runs locally
Most MCP servers run as a local process on your machine. Your credentials never leave your computer — the server handles auth directly.
Build your own
Any developer can publish an MCP server. If a tool you need doesn't have one yet, you can build it in TypeScript or Python in under an hour.
Add Your First MCP Server
All MCP servers are configured in one file. Here's how to add the filesystem server — the most useful one to start with — in under 2 minutes.
Open your OpenClaw config file
All MCP servers live under the mcpServers key in your config file. Open it in any text editor.
~/.openclaw/openclaw.json
Add an mcpServers block
Each entry needs a name, a command to start the server, and any args it needs. Here's the filesystem server, which gives OpenClaw read/write access to a folder you choose:
{ "mcpServers": { // Filesystem — read/write a local folder "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents" // folder to expose ] } } }
Restart OpenClaw
Stop and start OpenClaw. It will launch the MCP server process automatically and load its tools. You'll see them listed on startup:
🔌 MCP: filesystem — 5 tools loaded read_file · write_file · list_directory · create_directory · delete_file 🦞 OpenClaw is ready
Your agent can now use those tools
No extra commands needed. Just ask your agent to do something and it will call the MCP tools automatically:
"List all PDF files in my Documents folder and summarise the newest one" "Move all files older than 6 months into an Archive subfolder" "Create a file called meeting-notes.md with today's date as the title"
Use mcporter for easier management. Install the mcporter skill from ClawHub and you can add, remove, and inspect MCP servers through natural language — no config file editing needed. Just tell your agent "add the GitHub MCP server" and it handles the rest.
The Most Useful MCP Servers
These are the servers that power users install first. All are free and open-source unless noted.
Filesystem
OfficialRead, write, move, and search files in any folder you allow. The most commonly used MCP server — start here.
"filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/your/folder"] }
GitHub
OfficialRead repos, create issues, open and review PRs, push commits, and manage branches — all from a chat message.
"github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxx" } }
Notion
PopularRead pages and databases, create and update entries, search your Notion workspace — full two-way sync.
"notion": { "command": "npx", "args": ["-y", "@notionhq/notion-mcp-server"], "env": { "NOTION_API_KEY": "secret_xxxx" } }
Brave Search
Free tierReal-time web search without a Google API key. Free up to 2,000 queries/month. The easiest way to give your agent live internet access.
"brave-search": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-brave-search"], "env": { "BRAVE_API_KEY": "BSA_xxxx" } }
Slack
PopularRead channel history, post messages, create channels, and search across your entire Slack workspace.
"slack": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-slack"], "env": { "SLACK_BOT_TOKEN": "xoxb-xxxx", "SLACK_TEAM_ID": "T0XXXXXXX" } }
Stripe
OfficialQuery customers, invoices, and payment data. Create payment links and products. Your agent becomes your finance assistant.
"stripe": { "command": "npx", "args": ["-y", "@stripe/agent-toolkit", "--mcp"], "env": { "STRIPE_SECRET_KEY": "sk_xxxx" } }
PostgreSQL
PopularRun read-only SQL queries against your database and get results back as structured data. Safe, schema-aware, no accidental writes.
"postgres": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/mydb"] }
Memory
OfficialA persistent knowledge graph your agent can write to and query. Facts survive across sessions — great for remembering preferences, people, and projects.
"memory": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-memory"] }
Find more servers: The community-maintained awesome-openclaw-skills repo catalogues 5,400+ skills and MCP servers, filtered by category. Anthropic's own awesome-mcp-servers list is the most comprehensive index of all available servers.
What You Can Build with MCP
These are real workflows people run today by combining two or three MCP servers together.
Automated GitHub Project Manager
GitHub + SlackEvery morning your agent checks open PRs, flags anything waiting more than 24 hours for a review, and posts a summary to your #dev Slack channel. When a PR gets merged, it automatically closes the linked issue and updates the project board.
"Every weekday at 9am, check all open PRs in my repos. For any PR waiting more than 24h without a review, post a reminder to #dev on Slack. When PRs are merged, close the linked issue automatically."
Meeting Notes → Notion Automatically
Filesystem + NotionDrop a raw text file from your meeting recorder into a watched folder. OpenClaw picks it up via the filesystem server, formats it into a structured Notion page — with attendees, action items, and decisions — and files it in the right database.
"Watch ~/Downloads/meeting-notes/. Whenever a new .txt file appears, format it as a Notion page with sections for Summary, Attendees, Action Items, and Decisions. Add it to my Meetings database."
Daily Revenue Briefing via WhatsApp
Stripe + Agent ChannelsEvery evening your agent queries Stripe for the day's charges, calculates MRR delta, and sends you a clean one-message summary on WhatsApp — without you having to open a dashboard.
"Every day at 6pm, pull today's revenue from Stripe — total charges, new subscribers, and any failed payments. Send me a 3-line summary on WhatsApp."
Competitor Intelligence Report
Brave Search + FilesystemEvery Monday your agent searches for news about your competitors using Brave Search, compiles the findings into a markdown report, and saves it to a folder for you to read.
"Every Monday morning, search for recent news about [Competitor A] and [Competitor B]. Summarise any product updates, funding news, or pricing changes. Save to ~/Reports/competitor-intel-[date].md."
MCP Commands
Useful commands for managing your MCP servers from the terminal.
Test before you trust. After adding a new server, always run openclaw mcp test <name> to confirm it's live and returning the expected tools. Then ask your agent to use a simple read-only tool first before giving it write access.
MCP Security Best Practices
MCP servers run with the permissions of your user account. A misconfigured or malicious server has real access to your files, APIs, and data. Follow these rules.
-
Use scoped API tokens, not admin keys When creating tokens for GitHub, Notion, or Stripe, grant only the permissions that server actually needs. A read-only Stripe key can't accidentally charge customers; a repo-scoped GitHub token can't delete your whole organisation.
-
Limit filesystem server to specific folders Never point the filesystem server at
/or your home directory root. Create a dedicated~/openclaw-workspace/folder and restrict access to that. Your agent doesn't need access to your SSH keys or browser passwords. -
Only install well-maintained servers Check the GitHub repo: is it actively maintained? Are there open issues about security? Avoid servers with no source code visible or with fewer than 50 stars unless you've reviewed the code yourself.
-
Rotate tokens every 90 days Set a reminder to regenerate your API keys quarterly. Most platforms (GitHub, Notion, Stripe) support token expiry — use it. If a token is ever leaked, an expired one is worthless to an attacker.
-
Audit what tools are loaded Run
openclaw mcp listregularly and confirm you recognise every server and understand every tool it exposes. Remove any servers you're no longer using — fewer open connections means a smaller attack surface. -
Keep database servers read-only When connecting PostgreSQL or any database, use a read-only user account. Your agent can answer data questions perfectly well without ever having INSERT or DELETE privileges.
For a full security guide covering all of OpenClaw, see the Security & Safety page →
Frequently Asked Questions
npx -y command in the config examples downloads and runs the server without a permanent install. Install Node.js from nodejs.org if you don't have it. Python-based servers exist too and only need Python 3.x, which most systems already have.
@modelcontextprotocol/sdk) and Python (mcp). A minimal server that exposes two or three tools can be built in under 100 lines of code. The MCP protocol itself is JSON-RPC 2.0 over stdio or HTTP, so you can technically implement it in any language.