Skip to content

proofgeist/odata-mcp

Repository files navigation

FileMaker OData Monorepo

A complete toolkit for interacting with FileMaker databases via the OData API. This monorepo provides a TypeScript client library, an MCP server for AI assistants, and an n8n community node for workflow automation.

Packages

Package Description npm
fmodata TypeScript client library for FileMaker OData API npm
fmodata-mcp MCP server for AI assistants (Claude, Cursor, etc.) npm
n8n-nodes-filemaker-odata n8n community node for workflow automation npm

Quick Start

TypeScript Client

npm install fmodata
import { ODataApi, FetchAdapter } from "fmodata";

const client = ODataApi({
  adapter: new FetchAdapter({
    server: "https://your-server.example.com",
    database: "YourDatabase",
    auth: { username: "user", password: "pass" },
  }),
});

const records = await client.getRecords("Customers", { $top: 10 });

MCP Server (for AI Assistants)

Add to your Claude/Cursor MCP config:

{
  "mcpServers": {
    "filemaker": {
      "command": "npx",
      "args": ["-y", "fmodata-mcp"],
      "env": {
        "FM_SERVER": "https://your-server.example.com",
        "FM_DATABASE": "YourDatabase",
        "FM_USERNAME": "user",
        "FM_PASSWORD": "pass"
      }
    }
  }
}

n8n Node

In n8n: SettingsCommunity NodesInstalln8n-nodes-filemaker-odata

Authentication

All packages support:

  • Basic Auth - FileMaker account username/password
  • OttoFMS API Key - For OttoFMS users (recommended)

Development

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

# Watch mode
pnpm dev

Publishing

This monorepo uses Changesets for version management:

pnpm changeset      # Create a changeset
pnpm version-packages  # Version packages
pnpm release        # Publish to npm

License

MIT

Links