nalediym/touch-grass

What it does

nalediym/touch-grass is a Claude Code plugin and MCP (Model Context Protocol) server designed to promote user wellness by nudging you to take outdoor breaks. It analyzes local weather conditions, sunset timing, and your work session streaks to suggest optimal times for stepping outside. The tool operates entirely locally without requiring API keys or cloud storage, prioritizing privacy and simplicity.

How to set up

As an MCP server, installation involves adding it to your Claude configuration. Clone or download the repository from GitHub, then integrate it with your Claude environment. The fully local nature means no authentication or API key setup is required—simply run it and begin receiving break suggestions based on real-time local conditions.

Key features

• check_grass_conditions - Assesses current weather and outdoor conditions
• suggest_activity - Recommends specific outdoor activities based on weather
• log_touch_grass - Tracks your outdoor breaks and activity history
• get_stats - Displays wellness statistics and break patterns
• Local-first architecture - No cloud storage or external API dependencies
• Session streak monitoring - Encourages breaks based on continuous work duration