mcp-server-plaid: A Plaid MCP server

Overview

A Model Context Protocol server for facilitating integration with Plaid. This server provides tools to generate mock financial data, search Plaid documentation, and interact with sandbox APIs for testing purposes.

Tools

1. search_documentation

   • Search Plaid documentation for relevant information about products or API endpoints using with the help of Bill, the friendly robot platypus who reads our docs for fun.
   • Returns: Detailed information from Plaid's documentation

2. get_mock_data_prompt

   • Return prompt to generate customized mock financial data for testing

3. get_sandbox_access_token

   • Obtain a working access token for the Plaid sandbox environment
   • Returns: Access token and item ID for testing with sandbox mocked data

4. simulate_webhook

   • Simulate a Plaid webhook event in the sandbox environment
   • Useful for testing your application's webhook handling
   • Returns: Webhook fired status and status code

Configuration

Obtaining API Credentials

1. Sign in to your Plaid Developer Dashboard account
2. Navigate to Developers → Keys
3. Locate your sandbox credentials.

[!IMPORTANT] All PLAID_CLIENT_ID and PLAID_SECRET references in the following MCP configuration use sandbox credentials.

[!NOTE] All snippets below use uvx. If you installed via pip, swap uvx mcp-server-plaid for python -m mcp_server_plaid.

Usage with Claude Code

Add this to .mcp.json in your project root (or ~/.claude.json for a user-scoped install):

{
  "mcpServers": {
    "plaid": {
      "command": "uvx",
      "args": [
        "mcp-server-plaid",
        "--client-id",
        "YOUR_PLAID_CLIENT_ID",
        "--secret",
        "YOUR_PLAID_SECRET"
      ]
    }
  }
}

Or use the CLI:

claude mcp add plaid -- uvx mcp-server-plaid --client-id YOUR_PLAID_CLIENT_ID --secret YOUR_PLAID_SECRET

Usage with Cursor

For quick installation, use the one-click installation button.

For manual installation, add the following JSON block to Cursor MCP config file.

{
  "mcpServers": {
    "plaid": {
      "command": "uvx",
      "args": [
        "mcp-server-plaid",
        "--client-id",
        "YOUR_PLAID_CLIENT_ID",
        "--secret",
        "YOUR_PLAID_SECRET"
      ]
    }
  }
}

Usage with Codex

Add this to ~/.codex/config.toml:

[mcp_servers.plaid]
command = "uvx"
args = ["mcp-server-plaid", "--client-id", "YOUR_PLAID_CLIENT_ID", "--secret", "YOUR_PLAID_SECRET"]

Usage with VS Code

For quick installation, use one of the one-click installation buttons below.

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open Settings (JSON).

Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.

Note that the mcp key is needed when using the mcp.json file.

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "client_id",
        "description": "Plaid Client ID",
        "password": false
      },
      {
        "type": "promptString",
        "id": "secret",
        "description": "Plaid Secret",
        "password": true
      }
    ],
    "servers": {
      "plaid": {
        "command": "uvx",
        "args": ["mcp-server-plaid"],
        "env": {
          "PLAID_CLIENT_ID": "${input:client_id}",
          "PLAID_SECRET": "${input:secret}"
        }
      }
    }
  }
}

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "plaid": {
      "command": "uvx",
      "args": [
        "mcp-server-plaid",
        "--client-id",
        "YOUR_PLAID_CLIENT_ID",
        "--secret",
        "YOUR_PLAID_SECRET"
      ]
    }
  }
}

Usage with Zed

Add to your Zed settings.json:

{
   "context_servers": {
      "mcp-server-plaid": {
         "command": {
            "path": "uvx",
            "args": [
               "mcp-server-plaid",
               "--client-id",
               "YOUR_PLAID_CLIENT_ID",
               "--secret",
               "YOUR_PLAID_SECRET"
            ]
         }
      }
   }
}

Debugging

You can use the MCP inspector to debug the server. For uvx installations:

npx @modelcontextprotocol/inspector uvx mcp-server-plaid --client-id YOUR_PLAID_CLIENT_ID --secret YOUR_PLAID_SECRET

Or if you've installed the package in a specific directory or are developing on it:

cd path/to/servers/src/plaid
npx @modelcontextprotocol/inspector uv run mcp-server-plaid --client-id YOUR_PLAID_CLIENT_ID --secret YOUR_PLAID_SECRET

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.