Map View

Appearance

Obsidian CLI Integration ​

Map View registers commands with the Obsidian CLI, available since Obsidian 1.12.2. This lets you look up geolocations and add them to your notes from the command line or through Claude using the Map View skill.

It's highly recommended to use this together with obsidian-skills.

This lets agents like Claude Code be able to do things like:

  • "Add to my Paris Planning note a section with top 10 Indian restaurants. For each one, note why it's good and mention opening hours."
  • "Recommend me 10 places to stop in Napa Valley, add them to my daily note and show me the map. For each one, explain in one sentence why I should visit there."
  • "Recommend 5 coffee shops in NYC in the Times Square area that are open on Sunday at 7:00, and add them to a dedicated note."

Commands ​

mv-geosearch ​

Search for a location by name and return up to 10 results with coordinates.

bash
obsidian mv-geosearch name="Paris"

Example output:

1. Paris, Île-de-France, France [48.8566, 2.3522]
2. Paris, Texas, United States [33.6609, -95.5555]
...

Use this to find and verify the right result before recording it.

mv-geosearch-as-front-matter ​

Search for a location and return the top result as a front matter property.

bash
obsidian mv-geosearch-as-front-matter name="Eiffel Tower"

Example output:

location: "48.8584,2.2945"

Use together with obsidian property:set to set the location of a note.

mv-geosearch-as-inline ​

Search for a location and return the top result as an inline geolink.

bash
obsidian mv-geosearch-as-inline name="Eiffel Tower"

Example output:

[Eiffel Tower](geo:48.8584,2.2945)

Use to embed a location reference inside note content. Map View renders inline geolinks as clickable links and as pins on the map.

mv-focus-note ​

Focus a note in Map View, filtering the map to show only its locations.

bash
obsidian mv-focus-note file="Paris Trip"

The file parameter is resolved like a wikilink — name only, no path or extension needed. Opens (or switches to) Map View with a query scoped to that note.

Geocoding source ​

The geosearch commands use whichever geocoding source is configured in Map View's settings — OpenStreetMap (Nominatim) by default, or Google Places if configured.

Using with Claude ​

The Map View skill teaches Claude how to use these commands for trip planning, travel recommendations, and location research. With the skill installed, you can ask Claude things like:

  • "Plan a weekend in Rome and save the highlights to a note"
  • "Add the coordinates for this restaurant to my daily note"
  • "Create a trip note for Tokyo with the must-see sights"

Claude will use the available geosearch commands to look up each location and append the geolinks to your notes, which Map View then displays on the map.

To install the skill, copy the skills/map-view/ directory from the Map View repository into the skills directory of your agent tool:

  • Claude Code: copy into the .claude/skills/ folder at your Obsidian vault root
  • Codex CLI: copy into ~/.codex/skills/
  • OpenCode: copy into ~/.opencode/skills/