LiteFarm MCP Server

Model Context Protocol (MCP) server for LiteFarm API integration. Enables AI assistants to interact with LiteFarm farm management data.

Features

Farm management (list, get, create, update farms)
Animal tracking (individual animals and batches)
Crop management
Location management (fields, greenhouses, gardens)
Task management
Finance tracking (expenses, expense types)
Direct database access for complex queries

Setup

npm install
cp .env.example .env
# Edit .env with your credentials

Environment Variables

See .env.example for required configuration:

LITEFARM_API_URL - LiteFarm API endpoint
LITEFARM_EMAIL - Login email
LITEFARM_PASSWORD - Login password
DATABASE_URL - PostgreSQL connection string (optional, for db-tools)

Run

npm start

Project Structure

src/
  index.ts           # MCP server entry point
  litefarm-client.ts # API client
  types.ts           # TypeScript types
  tools/             # MCP tool implementations
    animal-tools.ts
    crop-tools.ts
    db-tools.ts
    farm-tools.ts
    finance-tools.ts
    location-tools.ts
    task-tools.ts
scripts/             # Utility scripts
docs/                # Documentation

MCP Integration

Add to your Claude Code MCP config:

{
  "mcpServers": {
    "litefarm": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/Litefarm-mcp-server"
    }
  }
}