Skip to main content
ntrp currently supports Slack through workspace tokens. A polished Slack OAuth install flow can be added later, but today the desktop setup assistant makes the token path explicit and verifies the token before saving.
1
Open Integrations settings
2
Go to Settings → Integrations → Slack.
3
Run the setup assistant
4
Click Run setup assistant.
5
Choose the token type:
6
  • Bot token — starts with xoxb-; best for posting and notifier-style behavior
  • User token — starts with xoxp-; useful when you need user-level Slack access
    • 7
    Paste and verify the token
    8
    Paste the token into the assistant and click verify. ntrp calls Slack auth.test and shows the workspace/user details if the token works.
    9
    Save the connection
    10
    After verification, save the token from the Integrations card. ntrp reloads integration clients automatically.

    ​
    Manual setup

    You can also set tokens through environment/config: 
    export SLACK_BOT_TOKEN=xoxb-...
export SLACK_USER_TOKEN=xoxp-...
    Or save the token in Settings → Integrations → Slack.

    ​
    Available tools

    ToolDescription
    slack_searchSearch Slack messages
    slack_channelRead channel history
    slack_threadRead a thread
    slack_dm / slack_dmsRead direct messages
    slack_fileRead Slack file/image content
    slack_post_messagePost a message (requires approval)
    slack_post_blocksPost block-kit content (requires approval)
    slack_user / slack_usersResolve Slack users

    ​
    Token notes

    • xoxb- bot tokens usually need the bot to be invited to private channels before it can read or post there.
    • xoxp- user tokens act as the installing user and should be treated as highly sensitive.
    • If verification fails, check the token prefix, workspace, revoked-token state, and Slack app scopes.

    ​
    Current limitation

    ntrp does not ship a shared Slack OAuth app yet. The setup assistant is intentionally honest: token setup now, OAuth install later.