Prerequisites
- Claude Code installed:
npm install -g @anthropic-ai/claude-code - A Pictory account with an active subscription or eligible Free Trial: app.pictory.ai. Available video minutes, voice-over usage, and AI Credits depend on your plan.
Connect
claude mcp list; the server shows as connected.
If you already added the Pictory connector in Claude and Claude Code is signed in to the same
account, you can use that connection.
claude mcp list shows it under the connector’s name, prefixed
claude.ai, and its tools are available in every session.What You Can Ask For
Claude Code checks your account automatically. It does not ask you to choose between these
video types. Pictory 3.0 users do not need separate activation for Motion Graphics.
The MCP server rejects Motion Graphics creation requests from Pictory 2.0 accounts.
Moving to Pictory 3.0 is a one-way change. If you use Pictory 2.0 and want Motion Graphics,
contact Pictory support to enable Pictory 3.0 for your account. After your account moves to
Pictory 3.0, you cannot switch back to Pictory 2.0. New videos you create through MCP will
use Motion Graphics only.
Scope and Sign-Out
Get the New Features: Existing Users
If this connection comes from the connector in your Claude account, follow the disconnect, remove, and add again steps in Claude first, then start a new Claude Code session. If you registered Pictory directly in Claude Code, sign out and remove that server registration. Follow the setup and sign-in steps on this page to add it again, using the same scope as before. Start a new session after reconnecting. Your saved Pictory projects stay in your account.Troubleshooting
The Sign-In Page Shows an Error Before You Can Log In
The Sign-In Page Shows an Error Before You Can Log In
Cause: The server was added without
--callback-port, so Claude Code used a random port and the return address did not match the registered one.Resolution:- Remove the server:
claude mcp remove pictory-ai-video - Add it again with the flag, exactly as shown above.
- Sign in:
claude mcp login pictory-ai-video
Port 3118 Is Already in Use
Port 3118 Is Already in Use
Cause: Another process is listening on that port, so Claude Code cannot open the callback listener. The port cannot be changed, because it is the one registered with Pictory.Resolution: Find the process with
lsof -i :3118, stop it or wait for it to finish, then sign in again.Tools Are Missing or Out of Date
Tools Are Missing or Out of Date
Cause: Claude Code reads the tool list when it connects, so a tool added since then is not visible.Resolution: Follow Get the new features: existing users, then start a new session.
Calls Fail After a Successful Sign-In
Calls Fail After a Successful Sign-In
Cause: The stored sign-in has expired, or the connected account does not have access to the requested feature or sufficient remaining usage.Resolution: Sign out and in again with
claude mcp logout then claude mcp login. Check the subscription at app.pictory.ai.Next Steps
Pictory MCP Server
Standard videos, motion graphics, and the options available through your connection
Connect from Claude Code
The same setup with scopes, sign-out and troubleshooting in full
Connect from Claude
Add Pictory as a custom connector in Claude on the web
Use Pictory with an LLM
Connect your assistant and see an example video conversation
