Sharesight-MCP

Sharesight-MCP

Docker app from Eurotimmy's Repository

An MCP (Model Context Protocol) server that lets AI assistants such as Claude read your Sharesight portfolio: portfolios, holdings, trades, payouts, performance and tax reports,…

Requirements

Sharesight API access (Client ID and Client Secret). Request it from support@sharesight.com.
Overview

An MCP (Model Context Protocol) server that lets AI assistants such as Claude read your Sharesight portfolio: portfolios, holdings, trades, payouts, performance and tax reports, cash accounts and more. Unofficial; uses the Sharesight v3 API.

:: BEFORE YOU START ::
You need Sharesight API access. Request it from support@sharesight.com, then copy your Client ID and Client Secret from your Sharesight API application. API access may require a particular Sharesight plan.

:: QUICK START ::

  1. Enter your Sharesight Client ID and Client Secret.
  2. Set MCP Auth Token to a long random string (e.g. run: openssl rand -hex 32). The container will not start without it. Every MCP client must send it as: Authorization: Bearer YOUR_TOKEN
  3. Start the container. The MCP endpoint is http://SERVER:3000/mcp and a health check is at /healthz.

:: SAFE BY DEFAULT ::
This template starts in READ-ONLY mode (read tools only). Set Read-only mode to false only if you want the AI to be able to create, change or delete trades, payouts and other data in Sharesight.

:: SECURITY ::
This server holds credentials to your financial data. Keep it on your LAN or VPN (e.g. Tailscale). If you publish it through a reverse proxy, put strong authentication in front of it and never share the auth token.

This is a community template. It is not affiliated with Sharesight or the sharesight-mcp authors. Please report template problems via the Support link.

Sharesight MCP for Unraid

Unraid Community Applications template for lethek/sharesight-mcp, an unofficial MCP (Model Context Protocol) server that lets AI assistants such as Claude read your Sharesight portfolio through the Sharesight v3 API.

This is a community template. It is not affiliated with Sharesight or the sharesight-mcp authors. Questions about the server itself belong on the project repo; template questions go to the support link in the template.

What you need first

  • Sharesight API access. Email support@sharesight.com to request it. Sharesight may require a particular plan.
  • Your API application's Client ID and Client Secret.

Quick start

  1. Install Sharesight-MCP from Community Applications.
  2. Enter your Sharesight Client ID and Sharesight Client Secret.
  3. Set MCP Auth Token to a long random string. On the Unraid terminal you can run openssl rand -hex 32. The container refuses to start without it.
  4. Start the container. Check http://SERVER:3000/healthz returns OK.
  5. Point your MCP client at http://SERVER:3000/mcp with the header Authorization: Bearer YOUR_TOKEN.

Example for Claude Code:

claude mcp add --transport http sharesight http://SERVER:3000/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Read-only by default

The upstream server defaults to read and write. This template defaults Read-only mode (MCP_READ_ONLY) to true, which leaves only the read tools and removes everything that creates, changes or deletes data. Set it to false only if you want your AI assistant to be able to edit Sharesight.

Settings

Setting Variable Default Notes
MCP port container 3000 3000 Change the host side if 3000 is taken.
Sharesight Client ID SHARESIGHT_CLIENT_ID Required.
Sharesight Client Secret SHARESIGHT_CLIENT_SECRET Required. Masked.
MCP Auth Token MCP_AUTH_TOKEN Required. Masked.
Read-only mode MCP_READ_ONLY true Upstream default is false.
Cursor secret MCP_CURSOR_SECRET random per start Set it so paging cursors survive restarts.
Max response characters MCP_MAX_RESPONSE_CHARS 30000 Minimum 5000.
Holdings cache (seconds) MCP_CACHE_TTL_SECONDS 60 0 disables.
Attachments folder path /attachments (read-only) Optional.
Attachments root MCP_DATA_ROOT empty Set to /attachments to enable attachment uploads.
Max attachment size MCP_MAX_ATTACHMENT_BYTES 10485760 Bytes.
Sharesight API base URL SHARESIGHT_BASE_URL https://api.sharesight.com Leave as is.

Security

This container holds credentials that can read (and, if you allow it, change) your financial records.

  • Keep it on your LAN or a VPN such as Tailscale.
  • If you publish it through a reverse proxy, add strong authentication in front of it.
  • Treat the auth token like a password and rotate it if it leaks.
  • Sharesight requires TLS 1.3 from 30 September 2026. The image is built on Node 24, which supports it.

Categories

Related apps

Links

Details

Repository
ghcr.io/lethek/sharesight-mcp:main
Last Updated2026-11-19
First Seen2026-11-18

Runtime arguments

Network
bridge
Shell
sh
Privileged
false
Extra Params
--restart=unless-stopped

Template configuration

MCP portPorttcp

HTTP port for the MCP endpoint (/mcp) and health check (/healthz). Change the host port if 3000 is already in use.

Target
3000
Default
3000
Value
3000
Sharesight Client IDVariable

Client ID of your Sharesight API application.

Target
SHARESIGHT_CLIENT_ID
Sharesight Client SecretVariable

Client Secret of your Sharesight API application.

Target
SHARESIGHT_CLIENT_SECRET
MCP Auth TokenVariable

Required. A long random string (e.g. openssl rand -hex 32). Clients must send it as an 'Authorization: Bearer' header. The container will not start without it.

Target
MCP_AUTH_TOKEN
Read-only modeVariable

true (default here) removes every tool that creates, changes or deletes Sharesight data. Set false to allow writes.

Target
MCP_READ_ONLY
Default
true|false
Value
true
Cursor secretVariable

Optional. Signs pagination cursors. If empty, a new random value is used on every start, so cursors stop working after a restart. Set any long random string to keep them valid.

Target
MCP_CURSOR_SECRET
Max response charactersVariable

Size limit for one page of a list, in characters (minimum 5000). Keep it under your AI client's tool-output limit.

Target
MCP_MAX_RESPONSE_CHARS
Default
30000
Value
30000
Holdings cache (seconds)Variable

How long the holdings list is cached for later pages. 0 turns the cache off.

Target
MCP_CACHE_TTL_SECONDS
Default
60
Value
60
Attachments folderPathro

Optional. Host folder holding files (e.g. contract notes) the AI may attach to trades and payouts. Only used when Read-only mode is false and Attachments root is set to /attachments.

Target
/attachments
Attachments rootVariable

Optional. Set to /attachments to enable uploading attachments from the folder above. Leave empty if you do not use attachments (the server refuses to start if this points to a folder that does not exist).

Target
MCP_DATA_ROOT
Max attachment size (bytes)Variable

Largest attachment, in bytes.

Target
MCP_MAX_ATTACHMENT_BYTES
Default
10485760
Value
10485760
Sharesight API base URLVariable

Leave as is unless you are testing or using a proxy. Must be https.

Target
SHARESIGHT_BASE_URL
Default
https://api.sharesight.com
Value
https://api.sharesight.com