Appfolio

Provides an MCP server to interact with the Appfolio Property Manager Reporting API via configurable environment and command-based integration.

javascript

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cryptocultcurt-appfolio-mcp-server": {
      "command": "npx",
      "args": [
        "@fluegeldao/appfolio-mcp-server"
      ],
      "env": {
        "VHOST": "YOUR_APPFOLIO_HOSTNAME",
        "PASSWORD": "YOUR_APPFOLIO_API_PASSWORD",
        "USERNAME": "YOUR_APPFOLIO_API_USERNAME",
        "NODE_OPTIONS": "--experimental-vm-modules"
      }
    }
  }
}

Appfolio MCP Server provides tools to interact with the Appfolio Property Manager Reporting API through a Model Context Protocol (MCP) server. It enables you to access Appfolio data and actions from MCP-compatible clients in a streamlined, configurable way.

How to use

You will run this MCP server as a local, self-contained process and connect to it from your MCP client. Start the server with the standard runtime command, then configure your client to point to the server or supply credentials so the client can authenticate with Appfolio. The server exposes API endpoints via the MCP protocol, enabling you to perform actions against the Appfolio Property Manager Reporting API in a controlled, scriptable manner.

How to install

Prerequisites you need before installation:

npm version 6.x or newer (recommended)
Node.js version that supports ES modules if you plan to use the optional VM modules option

Manual installation steps:

npm install @fluegeldao/appfolio-mcp-server

If you want to install via Smithery for Claude Desktop automation, run this command:

npx -y @smithery/cli install @CryptoCultCurt/appfolio-mcp-server --client claude

Additional notes

Configuration for running the MCP server using a local command typically involves invoking the MCP package with npx and supplying environment variables for Appfolio access. The example configuration below shows how you can set up the server within your MCP environment, including host, credentials, and an optional automatic restart.

Example configuration and run

{
  // ... other server configurations
  "appfolio": {
    "command": "npx",
    "args": ["@fluegeldao/appfolio-mcp-server"],
    "env": {
      "NODE_OPTIONS": "--experimental-vm-modules", // Optional, may depend on your Node version/setup
      "VHOST": "YOUR_APPFOLIO_HOSTNAME", // e.g., "yourcompany"
      "USERNAME": "YOUR_APPFOLIO_API_USERNAME",
      "PASSWORD": "YOUR_APPFOLIO_API_PASSWORD"
    },
    "restart": true // Optional: Restart the server if it crashes
  }
  // ... other server configurations
}

Security and credentials

Protect your Appfolio credentials by storing them securely in your MCP configuration or secret management system. Do not commit plain credentials to source control. Use environment variable management to inject values at runtime.

Troubleshooting

If the MCP server fails to start, verify that your Node.js version is compatible with the provided VM options and that the required environment variables are correctly set. Check that your environment has network access to the Appfolio API endpoints and that your credentials are valid.

Built by

VeilStrat

AI signals for GTM teams