Skip to content

MCP Integration Guide ​

cc-company works with MCP (Model Context Protocol) servers. Setting up MCP servers allows the secretary to directly operate external services.

How It Works ​

No special configuration is needed on the cc-company side. Just add MCP servers to Claude Code, and the secretary will automatically use them.

You: Schedule a meeting with Company A tomorrow at 2pm

Secretary: Added to your calendar!
           I've also added "Prepare meeting materials for Company A" to your TODOs.

Notion (Official) ​

Connect with your knowledge base and databases. The secretary can read and update Notion pages.

Method 1: OAuth (Recommended)

bash
claude mcp add-json notion '{"type":"http","url":"https://mcp.notion.com/mcp"}'

After running, OAuth authentication opens in your browser. No manual API key setup needed.

Method 2: API Token

bash
claude mcp add notion -e NOTION_TOKEN=ntn_YOUR_TOKEN -- npx -y @notionhq/notion-mcp-server

Create an API token at Notion Integrations.

Capabilities:

  • Read, create, and update Notion pages
  • Search and update databases
  • Secretary can reference your existing knowledge base

Google Calendar ​

Schedule management. The secretary can register meetings and set reminders.

bash
claude mcp add google-calendar \
  -e GOOGLE_OAUTH_CREDENTIALS=/path/to/gcp-oauth.keys.json \
  -- npx -y @cocal/google-calendar-mcp

Prerequisites:

  1. Create a project in Google Cloud Console
  2. Enable the Calendar API
  3. Create OAuth 2.0 credentials (Desktop app type)
  4. Download the credentials JSON

Capabilities:

  • Create, view, modify, and delete events
  • Show today's/this week's schedule
  • Check availability
  • Manage recurring events

GitHub (Official) ​

Repository management. Great synergy with the Engineering department.

Method 1: HTTP (Recommended)

bash
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'

Method 2: Docker

bash
claude mcp add github \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_PAT \
  -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Create a token at GitHub Settings > Developer settings > Personal access tokens.

Capabilities:

  • Create, view, and search issues
  • Manage and review PRs
  • Check repository status
  • Code search

Slack (Official) ​

Team communication. Works well with Sales and PM departments.

Method 1: OAuth (Recommended)

bash
claude mcp add-json slack '{"type":"http","url":"https://mcp.slack.com/mcp","oauth":{"clientId":"1601185624273.8899143856786","callbackPort":3118}}'

After running, Slack OAuth authentication opens in your browser.

Method 2: Install as plugin

bash
claude plugin install slack

Capabilities:

  • Send and check messages
  • Monitor channel activity
  • Look up user info
  • Client communication reminders

Note

Your workspace admin must have approved MCP integration.


Setup Methods ​

Just run the claude mcp add commands above. Restart Claude Code after setup.

Manual Configuration ​

Global settings (all projects): ~/.claude/settings.json

json
{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

Project settings (specific project only): .claude/settings.json

TIP

Put frequently used services (calendar, Notion) in global settings, and project-specific ones (GitHub) in project settings.


Examples with the Secretary ​

Once MCP servers are set up, the secretary uses them naturally.

> What's my schedule this week?
Secretary: Let me check your calendar.
      - Monday 10:00 Weekly meeting with Company A
      - Wednesday 14:00 Hearing with Company B
      - Friday All day Tax filing deadline
      Is the proposal for Company B on Wednesday ready?

> Summarize the meeting notes with Company A in Notion
Secretary: Done. Created a meeting notes page in Notion.
           I've also saved a summary in secretary/notes/.

> Create an issue for this bug
Secretary: Created an issue on GitHub.
           I've also logged it in engineering/debug-log/.

Works Without MCP Too ​

cc-company works perfectly fine without any MCP servers. The secretary functions fully with just file management within .company/.

MCP is a "nice to have" option.