GravityPort — Claude Code MCP server: features and setup
This MCP server for Claude Code connects an assistant to a GravityPort library. It can search and browse saved images, videos, prompts, and generation history.
no license ★ 14 updated 2026-11-15
claude mcp add gravityport -- npx -y gravityport-mcpWhat GravityPort does
GravityPort’s server lets an AI assistant search and browse assets in the local library, then record assets, prompts, versions, and generation history. The asset_search tool filters by text and a time range.
The server ships with the GravityPort desktop app and communicates over stdio without opening a port. Install and launch the app once, copy its configuration from settings into the client, then restart the client. Another option is npx -y gravityport-mcp, which requires Node.js 18 or newer.
What it helps with
- find images or videos by text and time range
- browse saved assets
- inspect an asset and its versions
- record generation details in the library
Example prompts for the agent
- Find GravityPort images matching “cover” from the last month.
- Show the latest assets in my GravityPort library.
- Record details about this generation and its version in GravityPort.
How to install GravityPort
Platform CLI
claude mcp add gravityport -- npx -y gravityport-mcpPlatform CLI
codex mcp add gravityport -- npx -y gravityport-mcpConfig file
{
"mcpServers": {
"gravityport": {
"command": "npx",
"args": [
"-y",
"gravityport-mcp"
]
}
}
}Config file
{
"servers": {
"gravityport": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gravityport-mcp"
]
}
}
}Platform CLI
gemini mcp add gravityport npx -y gravityport-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about GravityPort
How do I install GravityPort in Claude Code?
Install and open the GravityPort desktop app, then run claude mcp add gravityport -- npx -y gravityport-mcp. Restart Claude Code to connect.
What does GravityPort do?
It provides an MCP connection to a local GravityPort library. An assistant can search and browse assets, then record information about prompts, versions, and generation history.
What does GravityPort need to run?
Install and launch the GravityPort desktop app once. The npx -y gravityport-mcp setup also requires Node.js 18 or newer.