MCP

Connect your assets to AI.

Markie exposes your local asset library via MCP, so Claude and other AI tools can search and retrieve your files.

What is MCP?

Model Context Protocol (MCP) is a standard for AI assistants to access external tools and data sources securely.

Markie's MCP server is available as an npm package and exposes your personal asset library to Claude and other AI tools. Search by query, tag, file type, or description — all from within your AI conversations.

Your files stay local. Your AI accesses them through Markie, which controls exactly what can be searched and retrieved.

Claude
MCP Server
Markie Library

Example usage.

search_assets

Find that blue gradient poster I saved last week

gradient-poster-blue.png — PNG · 2.4 MB · saved 5 days ago
search_assets

Find all assets tagged "logo"

Found 12 assets matching tag: logo
get_asset_detail

Tell me more about that gradient poster

gradient-poster-blue.png — tags: inspiration, gradient · colors: #4f46e5, #3b82f6 · source: dribbble.com
get_asset_file

Get me the brand guidelines PDF

Retrieved brand-guidelines-v2.pdf — 8.7 MB
get_asset_thumbnail

Show me a preview of that poster

Thumbnail for gradient-poster-blue.png — 400×300
list_tags

What tags do I use most often?

inspiration (142), ui (98), typography (76), branding (61)
list_colors

What colors are in my library?

#d4775c (34), #4f46e5 (28), #34d399 (21), #fbbf24 (19)
get_recent

What did I save recently?

brand-guidelines.pdf, wireframes-v3.pdf, mood-board.pdf
get_stats

How big is my library?

1,247 assets · 4.2 GB · PNG (412), PDF (203), SVG (187), JPG (156)…

Available Tools

Use these MCP tools to interact with your Markie library programmatically. View full documentation →

search_assets

Full-text search with filters for type, tags, date range, and colors. Returns matching assets with metadata.

query?: string tags?: string[] type?: AssetType dateFrom?: string dateTo?: string colors?: string[] limit?: number

get_asset_detail

Get complete metadata for a specific asset including tags, colors, and source info.

id: string

get_asset_file

Retrieve the original file as base64. Maximum 10 MB.

id: string

get_asset_thumbnail

Retrieve a thumbnail image for visual preview of a specific asset.

id: string

list_tags

List all tags in your library, ranked by frequency.

(no parameters)

list_colors

List all dominant colors across your library, ranked by frequency.

(no parameters)

get_recent

Get the most recently saved assets in your library.

n?: number

get_stats

Library statistics including asset counts, total size, and file type breakdown.

(no parameters)

Quick Start

Claude Code

claude mcp add markie -- npx -y @vitgranen/markie-mcp

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "markie": {
      "command": "npx",
      "args": ["-y", "@vitgranen/markie-mcp"]
    }
  }
}

Other MCP Clients — use as stdio command

npx -y @vitgranen/markie-mcp

Ready to connect?