Tavern MCP server

Your tabletop RPG campaigns, as tools. Tavern keeps a TTRPG group's campaign in one place: dated sessions with everybody's notes, a wiki of the people, places and things in them, maps with pins, character sheets with live hit points and spell slots, a combat tracker, and each player's private notes. This server lets Claude, Cursor, VS Code or any MCP client work on all of it, acting as you at the tables you already sit at.

This repository holds the listing only: this README, the registry entry, the Gemini CLI extension manifest and the icon. The server is hosted by Tavern, so there is nothing to install or run.

What you can ask it

• "Recap Thursday's session from everybody's notes."
• "Start a wiki page for the ferryman at Hollowmere and link him in tonight's notes."
• "Ilsa takes 9 and she's prone."
• "Which threads from the last three sessions have we dropped?"
• "Set up a fight: the party against the three toll-bridge bandits."
• "What has my character got left?"

You need a free Tavern account and a campaign. Sign up at gettavern.app/signin.

Connect it

Claude

In Settings, under Connectors, add a custom connector and paste https://gettavern.app/mcp. Claude opens a Tavern page asking you to approve it.

Claude Code

claude mcp add --transport http tavern https://gettavern.app/mcp

Then run /mcp inside a session to sign in.

Cursor

Add it to ~/.cursor/mcp.json. Cursor asks you to sign in the first time it connects.

{
  "mcpServers": {
    "tavern": {
      "url": "https://gettavern.app/mcp"
    }
  }
}

VS Code

Add it to .vscode/mcp.json in a workspace, or to your user settings.

{
  "servers": {
    "tavern": {
      "type": "http",
      "url": "https://gettavern.app/mcp"
    }
  }
}

Gemini CLI

This repository is a Gemini CLI extension. Install it, then run /mcp auth tavern inside Gemini CLI to sign in.

gemini extensions install https://github.com/jakehandy/tavern-mcp

Anything else

Any client that speaks Streamable HTTP finds the sign-in on its own. A client that only takes a header can send a personal API key instead (make one in Tavern under Settings, API and assistants):

{
  "url": "https://gettavern.app/mcp",
  "headers": { "Authorization": "Bearer tvn_your_key" }
}

Signing in

The first time a client connects, the server answers 401 with a pointer to its sign-in, and the client opens Tavern's own consent page. You sign in there, see what the app is asking for, and may grant less than it asked.

• OAuth 2.1 for public clients: PKCE (S256), no client secret. A client registers itself, either through dynamic client registration (RFC 7591) or by being its own Client ID Metadata Document. Access tokens last an hour; refresh tokens rotate on every use.
• Scopes stack: read, then write, then delete. A client only sees the tools its scopes allow.
• Metadata: /.well-known/oauth-protected-resource/mcp and /.well-known/oauth-authorization-server. The full story is at gettavern.app/auth.md.
• Revoking: every key and connected app is listed under Settings, API and assistants, with when it was last used, and goes the moment you remove it.

A connected app is you and no more. It reaches the tables you sit at with the seat you hold at each, so a player's

... View full README on GitHub