Getting started
Install Midmap, connect an agent app, and optionally install the Skill or create a board directly.
Install Midmap
- Mac: Now available on the Mac App Store.
- Windows: Now available on the Microsoft Store.
Connect an agent app
Open the Midmap welcome screen, choose the agent app you use, and add Midmap MCP. You can manage the connection later under Settings → MCP.
- CLI apps: Copy the install command and run it in a terminal.
- Desktop apps: Copy the MCP configuration and paste it into the app’s MCP settings.
After setup, return to Midmap and check that the MCP service status is Running. If your app is not listed, choose Other to create a custom app entry, then add its configuration to the app.
For more app setup details, see MCP connections.
Optional: Install the Midmap Skill
The Midmap Skill is optional. It gives your agent instructions for using Midmap. After installing it, you can use /midmap in a conversation to start common tasks without explaining the steps each time.
Run this command in a terminal to install it, or send the Midmap Skill GitHub repository to your agent and ask it to install the Skill:
npx skills add midmap-app/skillsCreate your first board
You can click Skip for now and create a board on the Midmap welcome screen, or create a board later from the sidebar.
If you would like to explore Midmap with an agent first, install the Skill and connect MCP, then try this prompt in an agent conversation:
/midmap Create a board and show me how to use Midmap
Next steps
- What is Midmap?: Learn about Midmap and how boards are organized.
- Boards and nodes: Add nodes and organize information.
- Working with agents: Leave messages on nodes and review changes.