workvivo-mcp

Read-only Workvivo MCP server for Claude. It covers your company's activity feed, news articles, posts and shoutouts with their comments, events, the people directory, spaces, notifications and full-text search.

This project was developed and is maintained by AI (Claude Code). Use at your own discretion.

How it works

Workvivo sits behind your company's single sign-on, and its public API needs an admin-issued token. This server therefore makes no requests of its own. Every request runs in your already-signed-in Workvivo browser tab, relayed by the ContextMint Bridge extension over the fetchproxy bridge (127.0.0.1:37149). Each request is a same-origin fetch in your tab, with your session and your permissions. The server reads; it never posts, likes, comments, RSVPs or marks anything read.

Related MCP server: LinkedIn MCP Server

Setup

1. Install the ContextMint Bridge extension and sign in to your Workvivo site (e.g. https://acme.workvivo.us) in that browser.

2. Add the server to your MCP client:

   {
     "mcpServers": {
       "workvivo": {
         "command": "npx",
         "args": ["-y", "workvivo-mcp"],
         "env": { "WORKVIVO_HOST": "acme.workvivo.us" }
       }
     }
   }

3. Call workvivo_healthcheck. On the first run it returns a pair code. Approve it in the ContextMint Bridge popup (once; the trust persists).

Tools

Read tools return a compact projection by default. Pass view: "full" for Workvivo's record as sent. Credential-shaped fields, such as meeting passcodes and realtime tokens, are redacted in every view. Note that workvivo_search adds the query to your own Workvivo search history.

The endpoints and their quirks are documented in docs/WORKVIVO-API.md.

Without the server: the workvivo-fpx skill

skills/workvivo-fpx gives the same read access from a shell, using the fpx CLI and a sourceable helper (scripts/wv.sh), with ready-made jq recipes for each endpoint.

Development

npm install
npm run build   # tsc --noEmit + esbuild bundle → dist/bundle.js
npm test        # typecheck + vitest (all mocked; no network)

License

MIT