Skip to main content

​
Overview

Aptly provides a Model Context Protocol (MCP) server that lets AI assistants like Claude interact directly with your Aptly workspace. Once connected, your AI assistant can read boards, manage cards, and work with contacts without leaving the conversation.

​
Prerequisites

​
Getting your API token

Log in to your Aptly account and navigate to Settings > API. Generate a new token and copy it. Keep it safe, as it will not be shown again.

​
Setup

Add the following to your MCP client configuration file. In Claude Desktop, the config file is located at:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "aptlyMCP": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.getaptly.com/mcp",
        "--header",
        "Authorization:${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "YOUR_AUTH_TOKEN"
      }
    }
  }
}
Replace YOUR_AUTH_TOKEN with the token you copied from your account settings. Save the file and restart your MCP client. Aptly will appear as a connected tool.

​
What you can do

Once connected, you can ask your AI assistant to perform tasks like:
  • “Show me all cards on the Maintenance board”
  • “Create a new card for unit 4B with a move-in date of March 1”
  • “Post a comment on card ID abc123”
  • “Get the schema for my Leasing board”
  • “Look up contacts matching john@example.com”

​
Troubleshooting

The server does not appear in my client Ensure Node.js is installed and accessible from your terminal by running node --version. Restart your MCP client after saving any config changes. Authentication errors Confirm your token is valid and has not expired. You can generate a new token from Settings > API in your Aptly account. npx prompts for confirmation The -y flag in the config automatically accepts the mcp-remote package install. If you are still prompted, verify that your Node.js version is 18 or later.