Pexels
Pexels offers a free API that provides access to a vast library of high-quality photos and videos, enabling seamless integration into applications and websites.
Verdict
Common use cases
- Source hero images for landing pages
- Illustrate blog posts with licensed photos
- Pull trending videos for social campaigns
- Build mood boards from curated collections
- Grab photographer credits for attribution
Integration
- Vendor
- Pexels
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 8
- Composio slug
pexels
Tools
- Featured Collections
Tool to get featured collections. use when you need curated collections of photos and videos with pagination support.
- Get Collection Media
Tool to get all media within a collection by its id. use when you need to fetch paginated media from a specific collection.
- Get Curated Photos
Tool to get real-time curated photos. use when you need to fetch curated photos with pagination support.
- Get My Collections
Tool to get all of the user's collections on pexels. use when you need to list a user's collections with pagination support.
- Get Photo
Tool to retrieve detailed information about a specific photo. use when you have a valid photo id to fetch metadata including dimensions, photographer details, and image urls. use after confirming the photo id from search or curated endpoint
- Get Popular Videos
Tool to retrieve current popular pexels videos. use when you want to fetch trending videos from pexels.
- Search Photos
Tool to search for photos on pexels. use when you need to retrieve photos by a search term and optional filters. call after confirming you have a valid pexels api key.
- Search Videos
Tool to search for videos on pexels by query and optional filters. use when you need to find relevant video assets.
Setup
Setup guide
- 11. Go to pexels.com/api and sign up for a free API key (takes under a minute). 2. Copy the key from your dashboard. 3. In Switchy, open your workspace settings and navigate to Integrations. 4. Find Pexels in the MCP directory and click Connect. 5. Paste your API key when prompted and confirm. 6. Open any Space and type '@Pexels search photos of mountain sunrise' to test the connection. 7. The MCP should return a list of photos with URLs and metadata. 8. If you see results, the integration is live. 9. To fetch a specific photo later, use '@Pexels get photo [photo_id]' with an ID from a previous search. 10. For video assets, try '@Pexels search videos of ocean waves' to confirm video search works.
What teammates see: by default, memories from Pexels are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Find Campaign Visuals
@Pexels search photos of 'remote work lifestyle' and show me the top 10 results with download URLs and photographer namesOpen in a Space →
Get Trending Videos
@Pexels get popular videos and list the top 5 with titles, durations, and download linksOpen in a Space →
Browse Curated Collections
@Pexels show me featured collections and describe the first 3 with their titles and media countsOpen in a Space →
Pull Specific Asset Details
@Pexels get photo 1108099 and show me the photographer, dimensions, and all download URLsOpen in a Space →
Search Video B-Roll
@Pexels search videos of 'city traffic timelapse' and return 5 results with preview links and resolutionsOpen in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Pexels search for high-resolution photos of mountain landscapes at sunset, preferably in portrait orientation for our mobile app mockups.
Found 15 curated photos matching 'mountain landscapes sunset' with portrait orientation. Top results include a 4000×6000px image by photographer Maria Chen showing alpine peaks with golden hour lighting, a 3000×4500px shot by James Park featuring dramatic cloud formations over a ridgeline, and a 5000×7500px composition by Sarah Kim with foreground wildflowers. Each photo includes download URLs in multiple resolutions (original, large2x, large, medium, small) plus photographer attribution details and Pexels photo IDs for future reference.
This example demonstrates the search and filtering capabilities for photos. Users need a valid Pexels API key configured. The MCP returns metadata including dimensions, photographer credits, and multiple resolution URLs—but actual image content isn't embedded in the response. Rate limits apply based on your Pexels API tier, typically allowing thousands of requests per month for free accounts.
@Pexels get the details for photo ID 3408744 including all available download sizes and photographer information for our attribution requirements.
Retrieved details for Pexels photo 3408744. This is a 4016×6016px image titled 'Person Holding White Printer Paper' by photographer Andrea Piacquadio. Available download formats: original (4016×6016), large2x (1880×2820), large (940×1410), medium (427×640), small (213×320), portrait (800×1200), landscape (1200×627), and tiny (280×420). Photographer profile URL and Pexels photo page link included. Average color: #7E7265. This photo is free to use under the Pexels License.
This example shows how to fetch complete metadata for a specific photo when you already have its ID (perhaps from a previous search). Useful for verifying licensing terms, getting photographer attribution, or accessing specific resolution URLs. The MCP returns structured data about the image but doesn't download or display the actual photo file—you'll need to use the returned URLs in your application.
@Pexels find trending videos about 'team collaboration' under 30 seconds long, then summarize the top 3 by describing their visual content and suggesting which would work best for a SaaS landing page hero section.
Found 12 trending videos matching 'team collaboration' under 30 seconds. Analyzing top 3: (1) 20-second clip by VideoSupply showing diverse team in bright office doing a standing huddle—energetic, modern aesthetic, 1920×1080. (2) 15-second shot by Pressmaster of hands arranging sticky notes on glass wall—clean, strategic feel, 3840×2160 4K. (3) 25-second sequence by Fauxels with close-ups of laptop screens and coffee cups in coworking space—authentic, documentary style, 1920×1080. For a SaaS hero section, option (2) likely works best: the glass wall sticky notes convey strategic planning without showing faces (avoiding diversity token concerns), the 4K resolution ensures crisp display on retina screens, and the 15-second length loops smoothly without feeling repetitive.
This example combines the MCP's video search tool with the AI's visual reasoning to provide actionable recommendations. The MCP returns video metadata (duration, resolution, URLs, photographer) but cannot actually watch the videos—the AI infers content from titles, tags, and descriptions provided by Pexels. Duration and resolution filters help narrow results, but subjective quality assessment relies on the AI's interpretation of available metadata, not actual video analysis.
Use-case deep-dives
When Pexels MCP beats manual stock photo hunting
A 3-person marketing team running monthly campaigns across email, social, and landing pages needs 40-60 images per quarter. Without this MCP, someone spends 2-3 hours per campaign manually browsing Pexels, downloading files, and tracking usage rights. With the MCP, your AI workspace can search photos by campaign theme, filter by orientation or color, and pull metadata in one pass. The Search Photos and Get Curated Photos tools handle 90% of requests. The break-even is around 4 campaigns per year—below that, the API key setup overhead isn't worth it. If your team already uses a DAM or needs video more than stills, the 8-tool scope here is overkill. For small teams doing frequent visual content work with no dedicated designer, this MCP turns asset sourcing into a 10-minute Switchy task instead of an afternoon rabbit hole.
Why this MCP works for high-frequency content ops
A solo founder or 2-person content team publishing a weekly newsletter needs one hero image per issue—52 images per year, each tied to a specific topic or mood. The Pexels MCP shines here because the Search Photos tool lets you query by keyword and the Get Photo tool confirms licensing and dimensions before you commit. You avoid the context-switch of opening a browser, and your AI can batch-select images for the next 4 weeks in a single Switchy session. The threshold: if you're publishing less than monthly, the MCP setup is heavier than just bookmarking Pexels. If you need custom illustrations or brand-specific photography, stock tools won't cut it. For teams running predictable content calendars with generic visual needs, this MCP turns image selection from a creative bottleneck into a 5-minute checklist item.
When Pexels MCP is the wrong call for design work
A 4-person startup team building investor decks or client pitch presentations needs 10-15 images per deck, usually as section dividers or concept illustrations. The Pexels MCP can technically supply these via Search Photos or Featured Collections, but the workflow is backwards: designers already work in Figma or Keynote with direct Pexels plugins that preview images in-context. Routing through an AI workspace adds a step without adding value. The MCP makes sense only if your deck content is AI-drafted in Switchy first and you want to auto-suggest visuals inline with the narrative. If your team is design-led or uses presentation tools as the source of truth, skip this MCP. If you're a non-designer founder drafting decks in markdown or Google Docs and need placeholder art fast, the Search Photos tool can save you 20 minutes per deck.
Frequently asked
What does the Pexels MCP do in Switchy?
It lets your AI agents search and retrieve free stock photos and videos from Pexels directly inside conversations. Agents can pull curated images, search by keyword, fetch trending videos, or browse your saved Pexels collections — no manual downloads or tab-switching required. Useful when you need visual assets for mockups, presentations, or content drafts without leaving the workspace.
Do I need a paid Pexels account to connect the MCP?
No. You only need a free Pexels API key, which you can generate from your Pexels account settings. The key works with both free and Pexels Pro accounts, but the MCP itself doesn't require a subscription. Just paste the API key into Switchy's connection flow and you're set.
Can the Pexels MCP download images directly to my computer?
No. The MCP returns image URLs and metadata — dimensions, photographer credits, license info — but doesn't download files. Your agent can share the direct link to the full-resolution image, which you or your team can then download manually or pipe into another tool. Think of it as a search interface, not a file manager.
How is this different from just searching Pexels in a browser?
The MCP embeds search results into your AI workflow. Instead of opening Pexels, copying URLs, and pasting them back into a chat, your agent does it in one step — filtering by orientation, color, or collection, then citing the photographer and license inline. Faster for repetitive asset pulls, slower if you only need one image once.
Who on the team should connect the Pexels MCP?
Anyone who needs stock visuals in their AI conversations — designers, marketers, content writers. The API key is tied to a personal Pexels account, so whoever connects it will see their own saved collections in the 'Get My Collections' tool. If multiple people need access, each can connect their own key.