FXMacroData for Notion
Use FXMacroData in Notion as a macro research layer: Custom Agents can query the MCP server, databases can store release calendars and indicator rows, and Notion pages can hold live chart context through FXMacroData widget URLs.
Agent briefings
Connect a Notion Custom Agent to FXMacroData MCP and ask for release calendars, central-bank context, pair risk, and macro summaries.
Research databases
Sync FXMacroData REST responses into Notion databases for morning notes, event risk dashboards, and trade review workspaces.
Page context
Paste FXMacroData dashboard embed URLs into Notion pages where Notion supports the target URL as an embed.
Best path: Notion Custom Agent plus FXMacroData MCP
Notion Custom Agents can connect to hosted MCP servers. Use this path when you want a Notion-native analyst that can retrieve live FXMacroData data while drafting pages, updating notes, or answering workspace questions.
Production endpoint
https://fxmacrodata.com/mcp
Good first prompts
Build a EUR/USD macro brief for this week. What are the next USD economic releases? Compare AUD and NZD policy-rate pressure. Summarize recent JPY COT positioning.
Enable custom MCP servers
A workspace admin enables custom MCP servers under Notion AI connector settings when the plan supports Custom Agents.
Add FXMacroData to the agent
Open the Custom Agent settings, add a custom MCP server, and use https://fxmacrodata.com/mcp.
Authenticate for protected data
FXMacroData MCP keeps its existing OAuth flow, and direct REST examples keep using FXMacroData API keys outside Notion page content. The Notion connection below is a separate OAuth client flow used only to authorize FXMacroData to write into a user's Notion workspace.
Public Notion connection OAuth
FXMacroData includes website routes for a Notion public connection. Create the connection in Notion's developer portal with installation scope set to Any workspace, then register this redirect URI:
https://fxmacrodata.com/integrations/notion/callback
Website routes
GET /integrations/notion/install GET /integrations/notion/callback GET /integrations/notion/status POST /integrations/notion/sync POST /integrations/notion/disconnect
Required environment
NOTION_OAUTH_CLIENT_ID NOTION_OAUTH_CLIENT_SECRET NOTION_OAUTH_REDIRECT_URI NOTION_OAUTH_STATE_SECRET NOTION_TOKEN_ENCRYPTION_KEY NOTION_API_VERSION=2026-03-11
Generate the token encryption key with:
python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
OAuth state is signed, stored in an HTTP-only cookie for ten minutes, and validated before the authorization code is exchanged. Notion access and refresh tokens are encrypted before being stored under the signed-in FXMacroData user's Firestore record.
Reliable path: sync FXMacroData into Notion databases
For dashboards, morning notes, and repeatable desk workflows, store normalized FXMacroData rows in a Notion database. The website sync endpoint and the example script in examples/notion/ create or update release rows by stable source key. Authenticated FXMacroData request URLs are never written into Notion page properties.
| Property | Type | Purpose |
|---|---|---|
| Name | Title | Human-readable release or indicator row title. |
| Source Key | Rich text | Stable id used by the sync script to avoid duplicates. |
| Currency | Select | Currency code such as USD, EUR, AUD, or JPY. |
| Indicator | Rich text | FXMacroData indicator slug, such as inflation or policy_rate. |
| Release Date | Date | Scheduled release date or observation date. |
| Value | Number | Latest numeric value when available. |
| Endpoint | URL | Canonical FXMacroData API endpoint used for the row. |
python examples/notion/sync_fxmacrodata_to_notion.py \ --database-id YOUR_NOTION_DATABASE_ID \ --currency usd \ --indicator inflation \ --mode announcements
Fast path: paste FXMacroData widgets into Notion
FXMacroData exposes embeddable chart URLs for dashboard widgets. In Notion, create an Embed block and paste the HTTPS URL, not the iframe HTML. If Notion or its embed provider does not allow a specific widget URL, paste the same URL as a bookmark and keep the database sync as the stable data path.
https://fxmacrodata.com/dashboard/embed/EUR_USD/policy-rate-differential https://fxmacrodata.com/dashboard/embed/AUD_USD/inflation-comparison https://fxmacrodata.com/widgets
Can FXMacroData go in the Notion Marketplace?
Yes, but there are two different Marketplace tracks.
Connection listing
This is the correct track for a real FXMacroData product integration. It requires a public Notion connection with OAuth and installation scope set to Any workspace. Internal connections and selected-workspace public connections are not Marketplace eligible.
Template listing
This is the fastest listing track for a Notion-native product surface. Publish a Notion research workspace template, enable duplication, then submit it through the creator dashboard. Payments require a separate Stripe-based creator review.
Practical recommendation
Ship a free Notion template first, then build the public OAuth connection. The template validates demand and gives the Marketplace review team a visible Notion-native use case while the connection is being prepared for security and privacy review.
Build order
Now
Publish guide and sync example
Next
Create Notion research template
Then
Build public OAuth connection
Submit
Marketplace review with screenshots