# Kalen Docs

> How to connect Kalen to Claude, ChatGPT, Claude Code, Cursor or VS Code, what each of its tools does, and how plans, credits and approvals work.

Canonical: https://kalen.si/docs

Docs

Last updated November 18, 2026

Kalen is an X (Twitter) assistant that works inside your AI app. It researches what works in your niche, scores the drafts your AI writes, and schedules and publishes the posts you approve on your X account. Your AI writes the posts. Kalen does not run a writing model.

## Before you connect

- A Kalen account. You can create it with an email address or with Google during the first connection.
- An X account to publish to. You connect it from Kalen, through X’s own sign-in screen.
- A plan to schedule posts (Starter, Pro or Ultra, each with a 7-day free trial). Without a plan you can connect X, set up your profile and score drafts. Prices are on the [home page](https://kalen.si/#pricing).

## Connect Kalen

The connector URL is `https://kalen.si/mcp`.

### Claude (web, desktop and mobile)

1. Open **Settings → Connectors**.
2. Choose **Add custom connector**, name it Kalen and paste `https://kalen.si/mcp`.
3. Click **Connect**, sign in to Kalen and choose **Allow**.
4. In a chat, turn Kalen on from the tools menu and ask for your week of posts.

### ChatGPT

1. Open **Plugins** in the sidebar, click **Add** and choose **Add custom MCP server**.
2. Name it Kalen, keep **Server URL**, paste `https://kalen.si/mcp` and leave Authentication on **OAuth**.
3. Sign in to Kalen and choose **Allow**.

### Claude Code

Create an API key on the Setup page in your Kalen account, then run once in a terminal:

`claude mcp add --transport http kalen https://kalen.si/mcp --header "Authorization: Bearer <key>"`

### Cursor and VS Code

Add the server to `~/.cursor/mcp.json` or `.vscode/mcp.json` with the URL above and an `Authorization: Bearer <key>` header that uses a key from your Setup page.

## First steps

1. Ask your AI to start with Kalen. It calls `account`, which reports your plan, your X connection and your profile.
2. If X isn’t connected, open the link from `connect_x` and approve Kalen on X.
3. Tell your AI your niche, keywords, reference accounts, time zone, posting window and tone. It saves them with `setup_profile`.
4. Offer Kalen your voice: it can learn how you write from your posts and keep your stories (your numbers, what you shipped, your positions) with `voice`.

## Example prompts

- “Plan my week of posts on X and show me the table.”
- “Write three posts about what I shipped this week, score them and schedule the best two.”
- “Why did this post work? [https://x.com/…](https://x.com/%E2%80%A6)”
- “Turn this blog post into an X thread.”
- “Review my X profile and rewrite my bio.”

## Tools

Read tools only look things up. Write tools change something in your Kalen account or on X.

| Tool | Type | What it does |
|---|---|---|
| `account` | Read | Your plan, credits, X connection and profile. |
| `connect_x` | Read | A link to connect your X account. |
| `setup_profile` | Write | Saves your niche, keywords, reference accounts, time zone, posting window and tone. |
| `voice` | Write | Reads or saves your voice profile and story bank. |
| `get_briefing` | Read | The day’s research for your niche: what is working and why. |
| `refresh_moment` | Read | Today’s news and trends in your niche. |
| `plan_week` | Read | Pillars, open slots and post shapes for a week, and a balance check of the plan. |
| `get_slots` | Read | Your open posting slots. |
| `write_post` | Read | The method for one post or thread, with shapes and skeletons. |
| `write_article` | Write | The method and the niche’s most-saved X Articles, and a score of your draft. |
| `write_reply` | Write | Context to write replies to a post, and a score of the options. |
| `repurpose` | Read | Turns a LinkedIn post, blog post, newsletter or video script into a post or thread. |
| `score_posts` | Write | Scores drafts against your niche and flags what reads as machine writing. |
| `study_post` | Read | Why a post worked, to write one like it. |
| `insights` | Write | What is working for you or for another account. |
| `optimize_profile` | Write | A review of your X profile with a new bio to paste on x.com. |
| `upload_media` | Write | A link to upload images, GIFs or videos for a post. |
| `schedule_posts` | Write | Schedules approved posts on your X account. |
| `list_scheduled` | Read | Your queue of scheduled and published posts. |
| `update_post` | Write | Changes a scheduled post’s text, time or media. |
| `cancel_post` | Write | Cancels a scheduled post. |
| `inbox` | Write | Comments on your posts, to answer them. |

## Approvals

Kalen never publishes without your approval. `schedule_posts` first returns the plan for you to check, and only schedules after you say yes. `cancel_post` asks before it cancels. Replies and X Articles are posted by you on x.com.

## Credits and limits

Plans include monthly credits. Research and publishing spend them (a thread costs one credit a tweet). `account` shows your balance. Limits per plan are on the [home page](https://kalen.si/#pricing).

## Disconnect

Remove the connector in your AI app, or revoke an app from the Setup page in your Kalen account. Disconnect X from your Profile page in Kalen, or from your X settings. See the [Privacy Policy](https://kalen.si/privacy) for what we store and how to delete it.

## Support

Email [support@kalen.si](mailto:support@kalen.si).

Questions? [Contact support](mailto:support@kalen.si)
