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.
-
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
-
get_mock_data_prompt- Return prompt to generate customized mock financial data for testing
-
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
-
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
- Sign in to your Plaid Developer Dashboard account
- Navigate to Developers → Keys
- 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.
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_SECRETFor 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"
]
}
}
}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"]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
mcpkey is needed when using themcp.jsonfile.
{
"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}"
}
}
}
}
}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"
]
}
}
}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"
]
}
}
}
}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
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.