gardening-mcp

Disclaimer: Informational guidance only. Not professional horticultural advice. Results vary by local conditions, microclimate, and specific cultivars. Always verify with local extension services. See TERMS.md and PRIVACY.md.

MCP server (Model Context Protocol) for gardening and plant care. Helps gardeners plan, grow, and harvest with AI assistance.

Planting calendar, watering schedule, companion planting, pest identification, soil analysis, harvest planner, garden layout designer.

Pro Products

| Product | Price | Description | |---------|-------|-------------| | MCP Creator Kit | EUR 29 | Everything to create your own MCP server -- template, CLI, docs, examples | | SceneView Pro Starter Kit | EUR 49 | Complete Android 3D + AR app template -- 4 screens, ready to customize | | SceneView MCP Pro | EUR 9.99/mo | Premium MCP tools and priority support |

Sponsor on GitHub -- Help us build the future of AI-powered tools

Installation

npm install -g gardening-mcp

Or in your Claude Desktop / MCP configuration:

{
  "mcpServers": {
    "gardening": {
      "command": "npx",
      "args": ["-y", "gardening-mcp"]
    }
  }
}

Tools

plan_planting_calendar

Generate a month-by-month sow/transplant/harvest schedule based on USDA hardiness zone (1-13).

Parameters: zone, plants (array), season (optional: spring/summer/fall/winter/year_round).

calculate_watering

Calculate optimal watering frequency, amount, and timing. Accounts for soil type, climate, container growing, and sun exposure.

Parameters: plant_type, soil_type (clay/sandy/loam), climate (arid/temperate/tropical/continental/mediterranean), container (bool), sun_exposure (full_sun/partial_shade/shade).

find_companion_plants

Find good and bad companion plants with scientific reasoning and spacing recommendations.

Parameters: plant name.

identify_pest

Identify likely pests from observed symptoms. Returns top 3 matches with organic solutions and prevention.

Parameters: symptoms (yellowing/holes/wilting/spots/webbing), plant_type (optional), season (optional).

analyze_soil

Analyze soil quality from pH, NPK levels, and texture. Returns quality score (0-100), amendments, and crop recommendations.

Parameters: ph (0-14), nitrogen/phosphorus/potassium (low/medium/high), texture (clay/sandy/loam/silt/chalky/peat).

plan_harvest

Plan harvest dates from planting dates. Includes storage tips, succession planting, and harvest readiness signs.

Parameters: plants (array with name + planting_date), zone.

design_garden_layout

Design a garden with ASCII visualization. Accounts for sun direction, companion planting compatibility, and spacing.

Parameters: dimensions (width/length in meters), sun_direction (north/south/east/west), plants (array), style (raised_beds/rows/square_foot/permaculture).

Usage Examples

With Claude

"Plan a spring garden for zone 7 with tomatoes, basil, lettuce, and carrots"
"How often should I water my tomato in a clay soil container on a balcony?"
"What plants go well with tomatoes? What should I avoid?"
"My lettuce has holes in the leaves in spring — what pest is it?"
"My soil test shows pH 5.5, low nitrogen, medium P and K, sandy texture — what should I do?"
"I planted tomatoes May 1 and carrots April 15 — when do I harvest?"
"Design a 4x6m raised bed garden facing south with tomatoes, peppers, basil, and lettuce"

Programmatic

import { planPlantingCalendar } from "gardening-mcp/tools/plan-planting-calendar";

const calendar = planPlantingCalendar({
  zone: 7,
  plants: ["tomato", "lettuce", "carrot", "basil"],
  season: "spring",
});

Supported Plants

25 plants in the database: Tomato, Lettuce, Carrot, Pepper, Basil, Cucumber, Zucchini, Bean, Pea, Strawberry, Radish, Spinach, Kale, Onion, Garlic, Sunflower, Potato, Mint, Rosemary, Broccoli, Corn, Lavender, Parsley, Squash (Winter), Eggplant.

Development

npm install
npm test        # Run 150+ tests
npm run build   # Compile TypeScript
npm run dev     # Run with tsx (development)

License

Apache-2.0. See LICENSE.