How to install Actual MCP Server in Windsurf
To install Actual MCP Server in Windsurf, paste the "actual-mcp-server" block into ~/.codeium/windsurf/mcp_config.json and refresh the MCP panel in Cascade.
Built from the published package · server updated 2 days ago
- 1
Open the MCP config
In Windsurf, open Settings, then Cascade, then MCP servers, and choose to view the raw config.
- 2
Add the server
Paste this into mcp_config.json:
{ "mcpServers": { "actual-mcp-server": { "command": "npx", "args": [ "-y", "actual-mcp-server" ] } } } - 3
Refresh
Click refresh in the MCP panel. The server and its tools appear in Cascade.
Config file: ~/.codeium/windsurf/mcp_config.json
MCP servers run with your permissions. If Actual MCP Server needs an API key, add it under env in the config. Check its README.
Install Actual MCP Server in another app
Similar servers
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets
200+ transparent financial metrics calculated from raw statements, not third-party endpoints.
Questions
Does Actual MCP Server work in Windsurf?
Yes. Windsurf supports local and remote mcp servers, and Actual MCP Server installs with the steps above.
Actual MCP Server does not show up in Windsurf. What now?
Restart Windsurf fully, check the JSON is valid, and make sure Node.js (for npx) is installed. See common MCP errors and fixes.
Is Actual MCP Server safe?
It scores 84 of 100. Review the code before you install it, and only give it the access it needs. Grades and details.
