MCP Integration

Connect Tellnest to Claude Desktop, Claude Code, and other MCP-compatible AI clients. Publish HTML, choose exactly who can open it, manage contacts and groups, and email recipients, without leaving your editor.

Quick start — Claude Code

1. Create an API key at Settings → API Keys

2. Add the server for every project (user scope):

claude mcp add -s user --transport http tellnest https://tellnest.com/api/mcp \
  --header "Authorization: Bearer tn_live_your_key"

3. Start a new session. claude mcp list should show tellnest as connected.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json, then restart Claude Desktop:

{
  "mcpServers": {
    "tellnest": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://tellnest.com/api/mcp",
               "--header", "Authorization: Bearer tn_live_your_key"]
    }
  }
}

Available tools

publish_storywrite

Publish an HTML document. Share it with emails/@domains (share_with) or contact groups (share_with_groups); emails each recipient a link and your brief (message) unless notify is false.

update_storywrite

Replace HTML or title (same link), change audience, add or remove people and groups.

get_story_accessread-only

Who can open a story: audience, individual emails, and groups with their members.

list_my_storiesread-only

Your stories with links, audience and view counts.

list_contacts / add_contacts / remove_contactswrite

Your address book of emails and whole @domains.

list_groups / create_group / update_group / delete_groupwrite

Named groups of contacts. Membership is live: every story shared with a group follows its changes.

Claude Code plugin

Install via Claude Code plugin marketplace:

/plugin marketplace add ernesthilvano/tellnest
/plugin install tellnest@tellnest

Set TELLNEST_API_KEY in your environment first; the plugin sends it as a Bearer token. Then use /tellnest:publish-story and /tellnest:list-stories.

Authentication

Two auth methods are supported:

API Key — generate at Settings → API Keys. Pass as:

Authorization: Bearer tn_live_your_key
# or
X-API-Key: tn_live_your_key

OAuth 2.0 — for integrations that support OAuth. Use the authorization flow above. Access tokens start with tn_oauth_.

Support

Questions? Email hello@tellnest.com