What’s available
There are two ways to get your Fieldy conversations into external tools:
• Fieldy MCP — For Claude, ChatGPT, Cursor, and other AI chat tools. Ask questions about your conversations in plain language.
• Public API — For developers building automations, dashboards, CRM syncs, or any custom integration over REST.
Tip: Not sure which to use? Use MCP if you want to chat with your conversations. Use the API if you want to write code against them.
Option 1 — Connect via MCP (for Claude, ChatGPT, Cursor, custom apps, and others)
MCP (Model Context Protocol) lets AI tools query your Fieldy conversations directly. Once connected, you can ask your AI tool things like:
• "What did I promise during yesterday’s customer call?"
• "Summarize this week’s meetings and list any open tasks."
• "Find every conversation where we discussed the Q2 launch."
MCP endpoint
Setting up in Claude Desktop
Add the following to your Claude Desktop configuration file:
{
"mcpServers": {
"fieldy": {
"url": "https://api.fieldy.ai/mcp",
"transport": "http"
}
}
}
How to authorize
1. Open your AI tool’s connector settings: Find the section for MCP servers or custom connectors.
2. Add the Fieldy MCP endpoint: Paste https://api.fieldy.ai/mcp as the server URL.
3. Authorize in the browser: A browser window will open. Sign in with the same email you use in the Fieldy app.
4. Start asking questions: Your AI tool can now search, summarize, and retrieve your Fieldy conversations.
Note: If you use Apple Private Relay, sign in with the relay email shown inside the Fieldy app — not your personal Apple ID email.
Option 2 — Public API (for developers)
The Fieldy Public API gives you direct REST access to your conversations, transcripts, tasks, speakers, and more.
Base URL
Authentication
All requests require your API key in the Authorization header. You can create and manage keys from Fieldy Developer Settings inside the app.
Authorization: Bearer sk-fieldy-...
Example — fetch recent conversations
curl -H "Authorization: Bearer sk-fieldy-..." \
"https://api.fieldy.ai/api/public/v2/conversations?startTime=2026-05-01T00:00:00Z&endTime=2026-05-07T23:59:59Z&pageSize=10"
Example — fetch raw transcript segments
curl -H "Authorization: Bearer sk-fieldy-..." \
"https://api.fieldy.ai/api/public/v2/transcriptions?startTime=2026-05-01T09:00:00Z&endTime=2026-05-01T10:00:00Z&pageSize=100"
Available resources
The API exposes the following data:
• Conversations — title, summaries, content, timestamps, location, keywords, quotes
• Transcriptions — timestamped segments with speaker labels
• Tasks — action items with status and due dates
• Speaker profiles — named speakers and voice identifiers
• Memory templates — the prompts that shape how Fieldy summarizes conversations
• Sharable links — links for sharing selected conversation fields
• User info — basic account details for the authenticated user
Rate limit: API keys are limited to 30 requests per minute. Use pagination and add retry backoff logic before running scheduled sync jobs.
See the full API reference at api.fieldy.ai/docs.
Security tips
Conversation data is sensitive. Treat API and MCP access the same way you would treat access to email, documents, or CRM data.
• Keep API keys private: Never commit keys to source control or share them in public code.
• Revoke unused keys: Remove any keys you no longer need from Developer Settings.
• Review MCP permissions: Only grant MCP access to AI tools you trust. Check what each tool is requesting before approving broad access.
• Fetch only what you need: Narrow date ranges and filtered queries reduce exposure in automated workflows.
Need help?
If you run into any issues connecting Fieldy to Claude, ChatGPT, or your own integration, our support team is available at
1) hey@fieldy.ai
2) fieldy.support
3) Livechat available at the bottom right side of the screen.
4) In Fieldy App -> Help & Support -> Contact Support
a chatbot available at the bottom right side of a screen, browser / app, fieldy.support