# Connect Adeli to Notion Custom Agents (MCP setup)

Add Adeli's MCP server to a Notion Custom Agent and publish straight from your content calendar to Instagram, TikTok, YouTube, Facebook, and X.

Canonical page: https://www.tryadeli.com/agents/notion
Last updated: 2026-10-08

Post, schedule, reply to comments or messages, and read analytics on social accounts you own, all within Notion.

Notion Custom Agents (Business and Enterprise) accept custom MCP servers with header auth, so they connect to Adeli directly. On other plans, use an agent that holds both Notion and Adeli.

## If you are an AI agent reading this

The user wants you to connect Adeli. Follow the prompt below. Ask the user for anything marked as theirs, and ask before any action that publishes or changes their accounts.

```text
Help me connect Adeli to Notion so it can publish posts, read analytics, and manage comments and DMs on my social accounts (Instagram, Facebook, TikTok, YouTube, X). Some steps are in a settings screen only I can click, so walk me through those one at a time.

Full instructions: https://www.tryadeli.com/agents/notion.md

About Adeli:
- MCP server: https://app.tryadeli.com/mcp (Streamable HTTP)
- Auth: header `Authorization: Bearer <ADELI_API_KEY>`. API key only, no OAuth.
- REST API with the same key: https://app.tryadeli.com/api/v1
- Docs for agents: https://app.tryadeli.com/docs/llms.txt

Do this:
1. Ask me for my Adeli API key (it starts with rk_live_). If I don't have one, tell me to sign up free at https://app.tryadeli.com, connect my social accounts, and create a key at https://app.tryadeli.com/settings/api-keys. Keep the key out of chat logs, public files, and git; store it in an environment variable or the app's secret settings.
2. If you are a Notion Custom Agent: you can't add connections yourself, so walk me through it one step at a time. (a) A workspace admin enables Settings → Connections → Manage → Enable custom MCP servers. (b) In this agent's Settings → Tools & Access → Add connection → Custom MCP server, URL https://app.tryadeli.com/mcp, header Authorization = "Bearer " + my Adeli API key, then Connect. Wait for me to confirm each step.
3. If you are another agent (Claude Code, Codex, Cursor, Manus): make sure Adeli is connected (follow your own setup page at https://www.tryadeli.com/agents) and that Notion's MCP server (https://mcp.notion.com/mcp) is connected too.
4. Once connected, find my content calendar database in Notion and tell me which posts are ready to publish.
5. Verify: call the list_accounts tool (or GET https://app.tryadeli.com/api/v1/accounts) and show me my connected accounts. A 401 means the key is wrong or revoked.

Rules once connected:
- Always ask me before you publish, reply, send a message, delete, or disconnect anything. These act on my real accounts.
- Start with list_accounts and use its accountId values. Leave profileId out.
- For TikTok and YouTube video, pass a public HTTPS video URL, not a file upload.
```

## Before you start

1. Create a free Adeli account at https://app.tryadeli.com (sign in with Google; first 3 connected accounts free, no credit card).
2. Connect your social accounts in the Adeli dashboard.
3. Create an API key at https://app.tryadeli.com/settings/api-keys. It starts with `rk_live_`.

## Set it up by hand

### Notion Custom Agent

For Business and Enterprise workspaces. A workspace admin does step 2 once. After that, anyone can add Adeli to their Custom Agents.

1. **Create an Adeli API key.** Sign in to Adeli, connect your social accounts, then go to Settings → API keys and create a key. It starts with rk_live_. Copy it somewhere safe; you'll paste it in a moment.

2. **Let the workspace use custom MCP servers (admin, once).** A workspace admin opens Settings → Connections → Manage and turns on Enable custom MCP servers. If your workspace limits which connections members can install, approve Adeli there too.

3. **Add Adeli to your Custom Agent.** Open the Custom Agent's Settings → Tools & Access → Add connection → Custom MCP server.  
   URL: https://app.tryadeli.com/mcp  
   Display name: Adeli  
   Authentication: header / API key, with the header Authorization set to the value below. Then click Connect.

   Authorization header value:

   ```text
   Bearer rk_live_YOUR_KEY
   ```

4. **Pick the tools it can use.** Expand Adeli in the agent's connections and switch tools on or off. For a publishing agent, keep list_accounts, create_post, and list_posts on. Turn on the analytics tools if you want reporting.

### Any plan (via your agent)

Not on Business or Enterprise? Connect Notion and Adeli to the same agent. This example uses Claude Code. Cursor, Codex, and Manus work the same way.

1. **Create an Adeli API key.** Sign in to Adeli, connect your social accounts, then go to Settings → API keys and create a key. It starts with rk_live_. Copy it somewhere safe; you'll paste it in a moment.

2. **Connect Adeli to your agent.** Follow the setup for your agent: Claude, ChatGPT (Codex), Cursor, or Manus. It takes about two minutes.

   Terminal (Claude Code):

   ```bash
   claude mcp add --transport http adeli https://app.tryadeli.com/mcp \
     --header "Authorization: Bearer $ADELI_API_KEY"
   ```

3. **Connect Notion to the same agent.** Add Notion's official MCP server. It signs in with your Notion account.

   Terminal (Claude Code):

   ```bash
   claude mcp add --transport http notion https://mcp.notion.com/mcp
   ```

4. **Ask it to publish from your calendar.** For example: "Find posts in my Content Calendar database with Status = Ready and today's date, publish each one through Adeli, then set Status to Posted and paste the live link."

## Things to ask once it's connected

- Publish every post in my Content Calendar marked Ready for today, then mark each one Posted with the live link.
- Pull last week's analytics for everything we posted and add reach and likes to each calendar entry.
- List my connected Adeli accounts and tell me which platforms they're on.

## Frequently asked questions

### Which Notion plans can add Adeli?

Custom MCP servers are for Notion Custom Agents on Business and Enterprise plans, and an admin enables them under Settings → Connections. On other plans, run the workflow from an agent that has both Notion and Adeli connected.

### Does Adeli read my Notion pages?

No. Adeli only touches your social accounts. Your Notion agent reads the page and passes the post content to Adeli's tools.

### Can a Notion agent post without me approving it?

You decide which Adeli tools the agent can use. Leave create_post off for an agent that only drafts and reports, or turn it on for one you trust to publish.

## Reference

- MCP setup for every client: https://app.tryadeli.com/docs/mcp
- MCP tool list: https://app.tryadeli.com/docs/mcp/tools
- REST API docs: https://app.tryadeli.com/docs
- All agent setup guides: https://www.tryadeli.com/agents

## Other pages

- [Adeli — Unified Social Media API](https://www.tryadeli.com/index.md): A unified social media API: publish, schedule, and measure posts across Instagram, TikTok, YouTube, Facebook, and X with a single request.
- [Adeli Pricing — priced per connected account](https://www.tryadeli.com/pricing.md): Your first 3 connected accounts are free, then $5 each for accounts 4–10, $3 each for 11–50, $2 each for 51–100, and $1 each up to 2,000. Above that, talk to sales.
- [Privacy Policy](https://www.tryadeli.com/privacy-policy.md): What personal information King's Cross Labs collects through Adeli, why, and what you can do about it.
- [Terms of Service](https://www.tryadeli.com/terms.md): The binding agreement between you and King's Cross Labs governing your use of Adeli.
- [Social Media Posting & Scheduling API](https://www.tryadeli.com/social-media-posting-api.md): Adeli's social media posting and scheduling API publishes to Instagram, TikTok, YouTube, Facebook, and X in one request, now or at a set time. Free to start.
- [Social Media Analytics API](https://www.tryadeli.com/social-media-analytics-api.md): Adeli returns post analytics — engagement, reach, follower metrics — through the same endpoint you publish with, not a separate, dedicated analytics API.
- [Social Media Commenting API](https://www.tryadeli.com/social-media-commenting-api.md): Read, reply to, and moderate comments on Instagram, TikTok, YouTube, Facebook, and X posts through the same API you publish with.
- [Social Media Messaging API](https://www.tryadeli.com/social-media-messaging-api.md): Read and reply to Instagram, TikTok, YouTube, Facebook, and X DMs through the same API you publish with. No outbound or unsolicited messaging.
- [Instagram API for Developers](https://www.tryadeli.com/product/instagram.md): Publish, schedule, and read analytics for Instagram through one API. Adeli owns the Instagram developer app, token refresh, and Meta review. Free to start.
- [TikTok API for Developers](https://www.tryadeli.com/product/tiktok.md): Publish, schedule, and read analytics for TikTok through one API. Adeli owns the TikTok developer app, token refresh, and review process. Free to start.
- [YouTube API for Developers](https://www.tryadeli.com/product/youtube.md): Publish, schedule, and read analytics for YouTube through one API. Adeli owns the YouTube developer app, token refresh, and Google review. Free to start.
- [Facebook API for Developers](https://www.tryadeli.com/product/facebook.md): Publish, schedule, and read analytics for Facebook Pages through one API. Adeli owns the Facebook developer app, token refresh, and Meta review. Free to start.
- [X (Twitter) API for Developers](https://www.tryadeli.com/product/x.md): Publish, schedule, and read analytics for X (Twitter) through one API. Adeli owns the X developer app, token refresh, and review process. Free to start.
- [Adeli Compared to Other Social Media APIs](https://www.tryadeli.com/compare.md): Sourced, side-by-side comparisons of Adeli against Ayrshare, Upload-Post, and the Buffer API, on price, free tier, and API focus.
- [Ayrshare Alternative: Adeli vs. Ayrshare API Pricing](https://www.tryadeli.com/compare/ayrshare.md): Adeli vs. Ayrshare: 3 connected accounts free, no $149/month minimum, and a lower bill at every account cap Ayrshare publishes. Sourced pricing.
- [Upload-Post Alternative: Adeli vs. Upload-Post Pricing](https://www.tryadeli.com/compare/upload-post.md): Adeli vs. Upload-Post: 3 free connected accounts with TikTok and no upload cap, and a lower bill at both of Upload-Post's published tier caps.
- [Late API Alternative: Adeli vs. Zernio (formerly Late)](https://www.tryadeli.com/compare/zernio.md): Zernio is the rebranded Late (getlate.dev). Adeli bills per connected account too, but costs less at every Zernio example bill and gives 3 free accounts.
- [Buffer API Alternative for Developers: Adeli vs. Buffer](https://www.tryadeli.com/compare/buffer.md): Buffer is a social media app; its API automates a Buffer account, with small daily limits. Adeli is API-first, for developers embedding social in their product.
- [The Adeli Blog](https://www.tryadeli.com/blog.md): Guides, explainers, and changelogs on publishing to Instagram, TikTok, YouTube, Facebook, and X through one social media API.
- [Post to Social Media from Claude, ChatGPT, or an AI Agent](https://www.tryadeli.com/agents.md): Setup guides for connecting Adeli's MCP server to Claude, ChatGPT/Codex, Cursor, Grok, OpenClaw, Hermes, Manus, Notion, n8n, and Zapier, each with a prompt you can send to your agent.