Use Foldr with Claude Desktop (MCP)
Claude Desktop is the official Anthropic desktop client for Claude on macOS and Windows. It was the first mainstream app to ship MCP support in late 2024, making it the reference implementation for the protocol. Connecting Foldr lets Claude upload files, mint short links, and drop bio-page assets without leaving the chat window.
Installation
Add the Foldr MCP server to Claude Desktop with the snippet below. Replace fs_live_... with an API key from foldr.space/developers.
{
"mcpServers": {
"foldr": {
"command": "npx",
"args": ["-y", "@foldr/mcp-server"],
"env": {
"FOLDR_API_KEY": "fs_live_..."
}
}
}
}Setup tip: Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows, then restart Claude Desktop.
Official Claude Desktop MCP docsWhat You Can Do
- Upload any file from Claude Desktop to Foldr and get a shareable URL back in the same turn
- Shorten long URLs to foldr.space/s/... links without leaving Claude Desktop
- Create or update a Foldr bio page from a Claude Desktop conversation
- Generate a hosted Foldr form and paste the submission URL into your reply
- Hand off build artifacts, screenshots, and logs to a URL without leaving your editor
Claude Desktop + Foldr FAQ
How do I install the Foldr MCP server in Claude Desktop?
Open Claude Desktop's MCP configuration (the JSON settings file) and paste the config block shown above. Set FOLDR_API_KEY to a key you create at foldr.space/api-keys. Restart Claude Desktop if it doesn't hot-reload.
Which Foldr plan do I need to use the MCP integration with Claude Desktop?
The Foldr MCP server is available on every paid plan (Pro from $5/mo and Developer tier for API-heavy usage). The free tier can generate temporary 7-day links; for permanent storage, a Pro plan or Foldr Space is required.
I set the key but Claude Desktop says the Foldr tool isn't available — what's wrong?
The two most common issues: (1) Claude Desktop wasn't restarted after editing the config — most MCP hosts need a restart to pick up new servers. (2) Your API key is missing the `mcp:invoke` scope. Regenerate a key at foldr.space/api-keys with full scope and retry.
Can Claude Desktop upload files directly to Foldr, or just generate URLs?
Claude Desktop can do both. The MCP server exposes tools for `upload_file` (takes a local path or base64 blob), `shorten_url`, and `create_bio_page`. Any file Claude Desktop can read from disk can be uploaded.
Is the Foldr MCP integration with Claude Desktop production-ready?
Foldr's MCP server is stable and used in production. Claude Desktop's MCP support is currently stable and generally available. We pin to stable SDK versions and publish changelog entries for every breaking change.
Related MCP Integrations
Connect Claude Desktop to Foldr in under a minute
Grab an API key, paste the snippet above into Claude Desktop's MCP config, and your agent can upload files and share URLs immediately.
Get your Foldr API key