# Post to Social Media from Notion

Notion Agents can manage your OmniSocials content through the MCP Tools feature in Notion's agent settings. The connection is remote: Notion talks directly to the hosted OmniSocials MCP endpoint.

## Setup

1. Create an API key in OmniSocials (**Settings → API**)
2. In Notion, open **Settings → Connections → MCP Tools**
3. Click **Add tool**
4. Enter the MCP base URL:

```
https://mcp.omnisocials.com
```

5. Choose **Bearer Token** as the authentication method
6. Paste your OmniSocials API key as the token
7. Save

## Verifying

Invoke a Notion Agent in any page and ask:

> List my connected social accounts on OmniSocials

A successful response with your accounts confirms the integration. A `401` means the Bearer token is wrong. Double-check you copied the full key including the `omsk_live_` prefix.

## What you can do

Notion Agents can:

- Create, schedule, update, and publish posts
- Upload media from URLs
- List connected accounts and media library items
- Query analytics for posts and accounts

The agent respects your API key's scopes. For example, a key without `posts:write` can't create posts.

## Tips for working with Notion Agents

- Notion Agents work well with structured databases. Consider building a content calendar database in Notion and wiring an agent to push new rows to OmniSocials.
- Use Notion's automation triggers (e.g. "when status changes to Ready") to have the agent publish the post without manual intervention.
- Store platform-specific copy in separate database columns and let the agent map those to per-platform `content` on the post body.

## Limitations

- Notion's MCP Tools feature is in active development and may change
- Rate limits on the Notion side can limit how often an agent makes calls. OmniSocials' own 100 req/min limit applies independently.
- The Bearer Token method sends the key on every request, so it's secure. Unlike the URL-embedded variant used by ChatGPT, this key is not exposed in the connector URL.