Gated Gmail skill scaffold for OpenClicky. Use when the user asks to list, search, read, summarize, or draft replies to Gmail messages through local Google OAuth.

2026-07-09459

clicky-email-assistant

jasonkneen/openclicky

Draft, rewrite, summarize, triage, and prepare replies or outreach emails. Use for Gmail/Outlook/Mail tasks, email thread summaries, outbound sequences, follow-ups, humanizing drafts, and Gmail sends that require upgraded send permission plus explicit approval.

2026-07-02459

clicky-google-workspace

jasonkneen/openclicky

Use OpenClicky's Composio-backed Google Workspace integration for Gmail read/search, Gmail drafts and approved sends, Calendar events, Drive, Docs, Sheets, unread mail, files in Google Drive, and day-planning tasks.

2026-07-02459

cua-driver

jasonkneen/openclicky

Drive native macOS apps and browser UI through OpenClicky's local computer-use MCP background lane, backed by Cua. Snapshot state, prefer AX element_index actions, use explicit pixel/foreground paths only when the current OpenClicky tool surface exposes them, and verify via re-snapshot. Use when the user asks you to operate, drive, automate, or perform a GUI task in a real macOS application on the host.

2026-07-02459

gog

jasonkneen/openclicky

Use OpenClicky's local gog CLI as the primary Google Workspace route for Gmail read/search, optional Gmail send only when already connected and explicitly approved, Calendar, Drive, Docs, Sheets, Chat, Contacts, auth status, and account inspection. Prefer gog over browser automation for normal Google Workspace work.

2026-07-02459

google-workspace-gogcli

jasonkneen/openclicky

Connect to Google Workspace through the local gogcli (`gog`) command for Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat, Contacts, Tasks, Groups, Admin, Classroom, Forms, Apps Script, People, and Keep. Use when the user asks OpenClicky to use Google Workspace, Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat, Contacts, Tasks, Workspace Admin, or to set up/check gogcli auth.

2026-07-02459

name	maps
description	Geocode, POIs, routes, timezones via OpenStreetMap/OSRM.
version	1.2.0
author	Mibayy
license	MIT
metadata	{"openclicky":{"tags":["maps","geocoding","places","routing","distance","directions","nearby","location","openstreetmap","nominatim","overpass","osrm"],"category":"productivity","requires_toolsets":["terminal"],"supersedes":["find-nearby"]}}

OpenClicky compatibility guardrails

Follow ../_shared/OpenClickySkillCompatibilityPolicy.md before acting.
Verify required local commands, tools, keys, or bridge endpoints before promising execution.
Treat sends, publishes, deploys, deletes, moves, merges, playlist/library changes, cloud writes, and app-control clicks as external writes unless this skill narrows them further.
Stop and report the exact missing setup step for unavailable tools, auth, or macOS permissions; do not loop or silently switch to browser automation.

Maps Skill

Location intelligence using free, open data sources. 8 commands, 44 POI categories, zero dependencies (Python stdlib only), no API key required.

Data sources: OpenStreetMap/Nominatim, Overpass API, OSRM, TimeAPI.io.

This skill supersedes the old find-nearby skill — all of find-nearby's functionality is covered by the nearby command below, with the same --near "<place>" shortcut and multi-category support.

When to Use

User sends a Telegram location pin (latitude/longitude in the message) → nearby
User wants coordinates for a place name → search
User has coordinates and wants the address → reverse
User asks for nearby restaurants, hospitals, pharmacies, hotels, etc. → nearby
User wants driving/walking/cycling distance or travel time → distance
User wants turn-by-turn directions between two places → directions
User wants timezone information for a location → timezone
User wants to search for POIs within a geographic area → area + bbox

Prerequisites

Python 3.8+ or curl. This imported OpenClicky skill does not currently ship the old maps helper script, so use direct public APIs when no local helper exists.

Useful endpoints:

Nominatim search: https://nominatim.openstreetmap.org/search?format=json&q=...
Nominatim reverse: https://nominatim.openstreetmap.org/reverse?format=json&lat=...&lon=...
OSRM route: https://router.project-osrm.org/route/v1/driving/{lon1},{lat1};{lon2},{lat2}?overview=false

Commands

search — Geocode a place name

curl -s "https://nominatim.openstreetmap.org/search?format=json&q=" # search "Eiffel Tower"
curl -s "https://nominatim.openstreetmap.org/search?format=json&q=" # search "1600 Pennsylvania Ave, Washington DC"

Returns: lat, lon, display name, type, bounding box, importance score.

reverse — Coordinates to address

curl -s "https://nominatim.openstreetmap.org/reverse?format=json&lat=48.8584&lon=2.2945"

Returns: full address breakdown (street, city, state, country, postcode).

nearby — Find places by category

# By coordinates (from a Telegram location pin, for example)
python3 $MAPS nearby 48.8584 2.2945 restaurant --limit 10
python3 $MAPS nearby 40.7128 -74.0060 hospital --radius 2000

# By address / city / zip / landmark — --near auto-geocodes
python3 $MAPS nearby --near "Times Square, New York" --category cafe
python3 $MAPS nearby --near "90210" --category pharmacy

# Multiple categories merged into one query
python3 $MAPS nearby --near "downtown austin" --category restaurant --category bar --limit 10

46 categories: restaurant, cafe, bar, hospital, pharmacy, hotel, guest_house, camp_site, supermarket, atm, gas_station, parking, museum, park, school, university, bank, police, fire_station, library, airport, train_station, bus_stop, church, mosque, synagogue, dentist, doctor, cinema, theatre, gym, swimming_pool, post_office, convenience_store, bakery, bookshop, laundry, car_wash, car_rental, bicycle_rental, taxi, veterinary, zoo, playground, stadium, nightclub.

Each result includes: name, address, lat/lon, distance_m, maps_url (clickable Google Maps link), directions_url (Google Maps directions from the search point), and promoted tags when available — cuisine, hours (opening_hours), phone, website.

distance — Travel distance and time

python3 $MAPS distance "Paris" --to "Lyon"
python3 $MAPS distance "New York" --to "Boston" --mode driving
python3 $MAPS distance "Big Ben" --to "Tower Bridge" --mode walking

Modes: driving (default), walking, cycling. Returns road distance, duration, and straight-line distance for comparison.

directions — Turn-by-turn navigation

python3 $MAPS directions "Eiffel Tower" --to "Louvre Museum" --mode walking
python3 $MAPS directions "JFK Airport" --to "Times Square" --mode driving

Returns numbered steps with instruction, distance, duration, road name, and maneuver type (turn, depart, arrive, etc.).

timezone — Timezone for coordinates

python3 $MAPS timezone 48.8584 2.2945
python3 $MAPS timezone 35.6762 139.6503

Returns timezone name, UTC offset, and current local time.

area — Bounding box and area for a place

python3 $MAPS area "Manhattan, New York"
python3 $MAPS area "London"

Returns bounding box coordinates, width/height in km, and approximate area. Useful as input for the bbox command.

bbox — Search within a bounding box

python3 $MAPS bbox 40.75 -74.00 40.77 -73.98 restaurant --limit 20

Finds POIs within a geographic rectangle. Use area first to get the bounding box coordinates for a named place.

Working With Telegram Location Pins

When a user sends a location pin, the message contains latitude: and longitude: fields. Extract those and pass them straight to nearby:

# User sent a pin at 36.17, -115.14 and asked "find cafes nearby"
python3 $MAPS nearby 36.17 -115.14 cafe --radius 1500

Present results as a numbered list with names, distances, and the maps_url field so the user gets a tap-to-open link in chat. For "open now?" questions, check the hours field; if missing or unclear, verify with web_search since OSM hours are community-maintained and not always current.

Workflow Examples

"Find Italian restaurants near the Colosseum":

nearby --near "Colosseum Rome" --category restaurant --radius 500 — one command, auto-geocoded

"What's near this location pin they sent?":

Extract lat/lon from the Telegram message
nearby LAT LON cafe --radius 1500

"How do I walk from hotel to conference center?":

directions "Hotel Name" --to "Conference Center" --mode walking

"What restaurants are in downtown Seattle?":

area "Downtown Seattle" → get bounding box
bbox S W N E restaurant --limit 30

Pitfalls

Nominatim ToS: max 1 req/s (handled automatically by the script)
nearby requires lat/lon OR --near "<address>" — one of the two is needed
OSRM routing coverage is best for Europe and North America
Overpass API can be slow during peak hours; the script automatically falls back between mirrors (overpass-api.de → overpass.kumi.systems)
distance and directions use --to flag for the destination (not positional)
If a zip code alone gives ambiguous results globally, include country/state

Verification

python3 maps_client.py search "Statue of Liberty"
# Should return lat ~40.689, lon ~-74.044

python3 maps_client.py nearby --near "Times Square" --category restaurant --limit 3
# Should return a list of restaurants within ~500m of Times Square