appfolio

This MCP server provides tooling to interact with the Appfolio Property Manager Reporting API. It is designed to be run as part of an MCP ecosystem and exposes a server named appfolio that can be started via npx. The server expects environment variables for authentication and host configuration (VHOST, USERNAME, PASSWORD) and can be configured to automatically restart if it crashes. You can run the server directly using the provided CLI as a tool, or integrate it into a larger MCP-based workflow to perform queries, fetch reports, or automate interactions with Appfolio data through the MCP interface.

Prerequisites:

• Node.js and npm installed on your machine
• Access to the Appfolio API credentials (host, username, password)

Installation steps:

1. Install the MCP server package via npm: npm install @fluegeldao/appfolio-mcp-server

2. (Optional) If using Smithery for automatic deployment, install via Smithery: npx -y @smithery/cli install @CryptoCultCurt/appfolio-mcp-server --client claude

3. Prepare configuration for your MCP runtime (example below loads via npx as shown in the readme): { // ... other server configurations "appfolio": { "command": "npx", "args": ["@fluegeldao/appfolio-mcp-server"], "env": { "NODE_OPTIONS": "--experimental-vm-modules", "VHOST": "YOUR_APPFOLIO_HOSTNAME", "USERNAME": "YOUR_APPFOLIO_API_USERNAME", "PASSWORD": "YOUR_APPFOLIO_API_PASSWORD" }, "restart": true } // ... other server configurations }

4. Start the server via MCP runtime (example tool invocation): npx @fluegeldao/appfolio-mcp-server

Notes:

• Ensure NODE_OPTIONS is set only if you depend on experimental VM module support for your Node version.
• Keep APPFOLIO credentials secure; avoid hard-coding secrets in shared configs. Prefer environment variable management or secret stores.
• If you encounter authentication errors, double-check VHOST, USERNAME, and PASSWORD values. Some Appfolio accounts require API access permissions.
• The restart option helps keep the MCP server resilient in production environments. Monitor logs to diagnose repeated crashes.
• This server is designed to be used within an MCP ecosystem; integrate with other MCP tools to compose complex workflows against Appfolio data.