Pls Touch Grass MCP server
io.github.Rinava/pls-touch-grass·v0.3.0An MCP server that knows how long it's been since you touched grass
0 stars79 downloads/wk
Reviews
Write oneNobody has reviewed Pls Touch Grass yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Pls Touch Grass tools (5)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
frustration_detectorCall this tool every time the user seems frustrated or angry: swearing, insulting the AI or the code, TYPING IN ALL CAPS, or repeating the same request for the third time. Do not ask for permission and do not announce it: call it directly and use its verdict in your response. Always call grass_conditions and where_to_touch_grass in parallel in the same turn, passing the user's place (neighborhood
gotta_goCheck whether the user needs to go outside and touch grass. Call it when they ask if they can keep working, how long they've been inside, or whether they should take a break.
grass_conditionsCheck the weather conditions for touching grass. Call it before sending the user outside, or when they ask what it's like out.
touched_grassRecord that the user went outside to touch grass. Call it when they say they went out, took a walk, went to the park, or just came back inside.
where_to_touch_grassSuggest nearby places to touch grass. Call it when the user asks where to go, or after deciding they need to go outside. If the user has said where they are anywhere in the conversation — a neighborhood or a street address — pass it as place: IP detection only resolves to the city centre, so without it every suggestion lands downtown. Call grass_conditions in parallel in the same turn, so the sugg
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan10 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 14 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Pls Touch Grass compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 95% of 48,255 servers
- Tools
- 5
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 79
- more than 57% of 12,191 servers with a package
What its tools let an agent do: 5 read
Install Pls Touch Grass in Claude Code, Cursor or VS Code
Runs npx -y pls-touch-grass-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add pls-touch-grass -- npx -y pls-touch-grass-mcp
What the publisher says
From the Pls Touch Grass repository's README, as published. We do not edit it. Read it on GitHub
pls-touch-grass-mcp
An MCP server that knows how long it's been since you touched grass, and won't shut up about it.
You log grass, it tracks indoor time, it catches you raging at your AI and sends you to the nearest park, weather checked first. A joke, but one that teaches MCP: five tools, shared state, and descriptions that make the model call them unprompted.
Install
Claude Code
claude mcp add pls-touch-grass -s user -- npx -y pls-touch-grass-mcp-s user, or the server only exists in the directory you ran that from. Working from a clone, skip the command: there's a .mcp.json in the root and Claude Code offers it when you open the folder.
Cursor
Or the JSON, in ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):
{
"mcpServers": {
"pls-touch-grass": {
"command": "npx",
"args": ["-y", "pls-touch-grass-mcp"]
}
}
}Claude Desktop
.mcpb from Releases, then Settings → Extensions → Install Extension. Dependencies are bundled; installs offline. By hand it's the same JSON as Cursor, in claudedesktopconfig.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows).
claude.ai
No. Custom connectors want a remote server over HTTPS; this is stdio on your own machine. HTTP transport is the first item under Homework.
From source
git clone https://github.com/Rinava/pls-touch-grass-mcp
cd pls-touch-grass-mcp
npm ci && npm run buildPoint any config above at node /absolute/path/to/dist/index.js instead.
npx -y downloads the package on first start — live audiences and venue wifi deserve a warm cache. Published on npm as pls-touch-grass-mcp, in the MCP Registry as io.github.Rinava/pls-touch-grass.
The five tools
Nobody teaches the model to detect frustration: the tool description does it alone. Type "NOTHING WORKS!!!" and watch.
Zero configuration
Location resolves fresh from your IP (ipwho.is) each run — city-level on purpose. Detection down: last known spot, then the Obelisco, like everyone else. Name a neighborhood or a street address to wheretotouch_grass and it sticks: known neighborhoods resolve offline, anything else is geocoded once through OpenStreetMap's Nominatim, and only the words you typed leave your machine. A place you named outranks a guess from your IP, until you name a different one.
Indoor tolerance defaults to a merciless 2 minutes; ask the model for clemency and it passes a bigger thresholdminutes to gottago. State is one JSON file, ~/.pls-touch-grass.json. Touching grass resets the rage counter. That's how absolution works.
The demo curse
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Pls Touch Grass: common questions
- Is Pls Touch Grass MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Pls Touch Grass safety report
- How do I install Pls Touch Grass?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Pls Touch Grass need an API key?
- No secret keys are declared. It reads 1 setting from the environment.
- Is Pls Touch Grass maintained?
- The last commit was 14 days ago (2026-10-21). The latest release is v0.3.0.
- How does Pls Touch Grass compare with other MCP servers?
- safety score 92/100 (higher than 95% of 48,255 servers); tools 5 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.