MCP Server (Windows) #
Flexible’s desktop app can run a built-in MCP (Model Context Protocol) server. It lets external AI tools and agents — such as Claude Desktop, AI-enabled editors, or your own scripts — connect securely to Flexible and work with your data on your behalf. This is the opposite direction from the in-app AI Assistant: MCP is about letting outside AI reach into Flexible. It is a Windows-only feature and is turned off by default.
Enable the server #
Go to Settings → MCP:
- Turn the MCP server on.
- Generate an API key — connecting clients must present it.
- Note the address. By default the server listens locally at
http://127.0.0.1:9458/mcp(the port is configurable).
Connect a client #
Point any MCP-compatible client at the server:
- URL:
http://127.0.0.1:<port>/mcp(Streamable HTTP transport) - Authorization:
Bearer <your API key>
Flexible must be running for the server to respond.
What the server exposes #
Connected AI tools can:
- Read from and write to your Flexible data (tasks, habits, finances, and more) through the app’s database
- Inspect the database schema
- Navigate the app to a specific screen
- Read the current app state
- Send you a desktop notification
Security #
- The server binds to localhost only (127.0.0.1) and does not accept connections from other machines.
- Every request must include your API key. Regenerate the key at any time to revoke existing access.
- Enable MCP only if you actually use an external AI client — otherwise leave it off.