Skip to main content

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.

📦

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:

~/.openclaw/openclaw.json
{
  "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:

Terminal output
🔌 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:

WhatsApp / Telegram / Web UI
"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

Official

Read, write, move, and search files in any folder you allow. The most commonly used MCP server — start here.

read_filewrite_filelist_directorymove_filesearch_files
"filesystem": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-filesystem", "/your/folder"]
}

GitHub

Official

Read repos, create issues, open and review PRs, push commits, and manage branches — all from a chat message.

create_issuecreate_prlist_commitspush_filesearch_code
"github": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-github"],
  "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxx" }
}

Notion

Popular

Read pages and databases, create and update entries, search your Notion workspace — full two-way sync.

searchget_pagecreate_pageupdate_pagequery_database
"notion": {
  "command": "npx",
  "args": ["-y", "@notionhq/notion-mcp-server"],
  "env": { "NOTION_API_KEY": "secret_xxxx" }
}

Brave Search

Free tier

Real-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_web_searchbrave_local_search
"brave-search": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-brave-search"],
  "env": { "BRAVE_API_KEY": "BSA_xxxx" }
}

Slack

Popular

Read channel history, post messages, create channels, and search across your entire Slack workspace.

post_messagelist_channelsget_historysearch_messages
"slack": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-slack"],
  "env": {
    "SLACK_BOT_TOKEN": "xoxb-xxxx",
    "SLACK_TEAM_ID": "T0XXXXXXX"
  }
}

Stripe

Official

Query customers, invoices, and payment data. Create payment links and products. Your agent becomes your finance assistant.

list_customersget_invoicecreate_payment_linklist_charges
"stripe": {
  "command": "npx",
  "args": ["-y", "@stripe/agent-toolkit", "--mcp"],
  "env": { "STRIPE_SECRET_KEY": "sk_xxxx" }
}

PostgreSQL

Popular

Run read-only SQL queries against your database and get results back as structured data. Safe, schema-aware, no accidental writes.

querydescribe_tablelist_tables
"postgres": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-postgres",
    "postgresql://user:pass@localhost/mydb"]
}

Memory

Official

A persistent knowledge graph your agent can write to and query. Facts survive across sessions — great for remembering preferences, people, and projects.

create_entitiescreate_relationssearch_nodesadd_observations
"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 + Slack

Every 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.

What you tell your agent (once)
"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 + Notion

Drop 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.

What you tell your agent (once)
"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 Channels

Every 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.

What you tell your agent (once)
"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 + Filesystem

Every 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.

What you tell your agent (once)
"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.

Command What it does
openclaw mcp listShow all configured MCP servers and their loaded tools
openclaw mcp statusShow which servers are running, stopped, or erroring
openclaw mcp restart <name>Restart a specific MCP server without restarting OpenClaw
openclaw mcp logs <name>View stdout/stderr output from an MCP server process
openclaw mcp test <name>Ping the MCP server and verify its tools/list response
openclaw mcp disable <name>Temporarily disable a server without removing its config
openclaw mcp tools <name>List every tool a server exposes with its parameters
🧪

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 list regularly 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

ClawHub skills are OpenClaw-specific packages — they include a SKILL.md with instructions, pre-configured prompts, and sometimes bundled MCP servers. An MCP server is lower-level: it exposes raw tools that any MCP-compatible AI agent can use. Many skills install and configure an MCP server behind the scenes. If there's a ClawHub skill for what you need, start there — it's easier. If not, install the MCP server directly.
Most MCP servers are distributed as npm packages, so yes — Node.js is required for those. The 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.
Yes — OpenClaw launches all configured servers simultaneously and makes all their tools available to the agent at once. Users commonly run 5–10 servers at the same time (filesystem, GitHub, Notion, Brave Search, Slack, memory) with no issues. Each server runs as a separate background process, so they're isolated from each other.
The AI model decides. When you send a task, OpenClaw includes a list of all available tools (from all loaded MCP servers) in the context. The model reads the tool descriptions and picks the right one, or chains several together. You never need to specify which tool to use — just describe what you want in plain English.
Yes, and it's well within reach for any developer. Anthropic provides official SDKs for TypeScript (@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.
The MCP servers themselves are always free and open-source. You may need API keys for the underlying services — Brave Search has a free tier (2,000 queries/month), GitHub tokens are free, Notion API is free, Stripe's API is free to query (you pay per transaction, not per API call). Check the specific service's pricing for anything beyond basic usage.

Get New MCP Server Picks by Email

The best new MCP servers, real config examples, and OpenClaw automation ideas — weekly.

No spam. Unsubscribe any time.